Subject: Re: Confusion over "This page in other versions" links
From: Jeff Davis <pgsql@j-davis.com>
To: Heikki Linnakangas <heikki.linnakangas@enterprisedb.com>
Cc: pgsql-docs@postgreSQL.org
In-Reply-To: <502A293E.70403@enterprisedb.com>
References: <502A293E.70403@enterprisedb.com>
Content-Type: text/plain; charset="ISO-8859-1"
Date: Tue, 14 Aug 2012 18:05:48 -0700
Message-ID: <1344992748.25533.31.camel@sussancws0025>
Mime-Version: 1.0
Content-Transfer-Encoding: 7bit

On Tue, 2012-08-14 at 13:32 +0300, Heikki Linnakangas wrote:
> I just had a discussion with someone off-list, where he was looking at 
> the documentation page of a contrib module at www.postgresql.org/docs. 
> Looking at the page, he came to the conclusion that the module was no 
> longer supported in 9.2, because the header at the top of the page said:
> 
> "This page in other versions: 9.1 / 9.0 / 8.4 / 8.3  |  Unsupported 
> versions: 9.2 / devel"
> 
> I find the links really helpful, but apparently they can be 
> misunderstood. Perhaps we should change the "Unsupported versions" text 
> to "future versions" or "Development versions". Or change "9.2" to "9.2 
> (beta)", and remove the "Unsupported versions" text altogether.

Or perhaps:

"This document for version: 9.1 / 9.0 / 8.4 / 8.3 | devel / 9.2 (beta) |
Old versions: 8.2 / 8.1 / ..."

I didn't read the original rationale, but it's not clear to me why we
have quick links to the documents for unsupported versions. Maybe just
have one link "unsupported versions" that goes to
http://www.postgresql.org/docs/manuals/archive/ ?

Regards,
	Jeff Davis