Re: Confusion over "This page in other versions" links - Mailing list pgsql-docs

From Jeff Davis
Subject Re: Confusion over "This page in other versions" links
Date
Msg-id 1344992748.25533.31.camel@sussancws0025
Whole thread Raw
In response to Confusion over "This page in other versions" links  (Heikki Linnakangas <heikki.linnakangas@enterprisedb.com>)
List pgsql-docs
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



pgsql-docs by date:

Previous
From: Daniele Varrazzo
Date:
Subject: Re: GIST operators docs [was: [HACKERS] Patch: add GiST support for BOX @> POINT queries]
Next
From: Chris Travers
Date:
Subject: Re: Would like to contribute a section to docs for 9.3. Where to start?