Re: [DOCS] Confusion over "This page in other versions" links

From: Bruce Momjian <bruce(at)momjian(dot)us>
To: Jeff Davis <pgsql(at)j-davis(dot)com>
Cc: Heikki Linnakangas <heikki(dot)linnakangas(at)enterprisedb(dot)com>, PostgreSQL www <pgsql-www(at)postgresql(dot)org>
Subject: Re: [DOCS] Confusion over "This page in other versions" links
Date: 2012-09-01 15:58:52
Message-ID: 20120901155852.GC2969@momjian.us
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs pgsql-www

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. +

In response to

Responses

Browse pgsql-docs by date

  From Date Subject
Next Message Bruce Momjian 2012-09-01 16:05:24 Re: Clarification suggestion for 46.4 chapter.
Previous Message Bruce Momjian 2012-08-31 17:57:57 Re: GIST operators docs [was: [HACKERS] Patch: add GiST support for BOX @> POINT queries]

Browse pgsql-www by date

  From Date Subject
Next Message Bruce Momjian 2012-09-02 12:54:07 Re: searching for git commit hash
Previous Message Bruce Momjian 2012-08-31 14:05:10 Re: Login to wiki expires every hour?