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(at)momjian(dot)us> http://momjian.us
EnterpriseDB http://enterprisedb.com

+ It's impossible for everything to be true. +