Обсуждение: Re: [DOCS] Confusion over "This page in other versions" links

On Tue, Aug 14, 2012 at 06:05:48PM -0700, Jeff Davis wrote:
> 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/ ?

I am sending this to the www list, which is where these headers are
generated.

--  Bruce Momjian  <bruce@momjian.us>        http://momjian.us EnterpriseDB
http://enterprisedb.com
 + It's impossible for everything to be true. +

On Sat, Sep 1, 2012 at 8:58 AM, Bruce Momjian <bruce@momjian.us> wrote:
> On Tue, Aug 14, 2012 at 06:05:48PM -0700, Jeff Davis wrote:
>> On Tue, 2012-08-14 at 13:32 +0300, Heikki Linnakangas wrote:

>> 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/ ?

I have found the direct links to old/unsupported versions of the
current page to come in handy several times, e.g. when I'm interested
in how a system catalog has changed over time I can quickly open all
the different versions in separate browser tabs to catch any
differences. I could see reorganizing the current "Unsupported
versions" section into Future Version(s) and Unsupported/Obsolete
Versions, though.

Josh