public inbox for [email protected]help / color / mirror / Atom feed
Confusion over "This page in other versions" links 4+ messages / 4 participants [nested] [flat]
* Confusion over "This page in other versions" links @ 2012-08-14 10:32 Heikki Linnakangas <[email protected]> 0 siblings, 1 reply; 4+ messages in thread From: Heikki Linnakangas @ 2012-08-14 10:32 UTC (permalink / raw) To: pgsql-docs 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. -- Heikki Linnakangas EnterpriseDB http://www.enterprisedb.com ^ permalink raw reply [nested|flat] 4+ messages in thread
* Re: Confusion over "This page in other versions" links @ 2012-08-15 01:05 Jeff Davis <[email protected]> parent: Heikki Linnakangas <[email protected]> 0 siblings, 1 reply; 4+ messages in thread From: Jeff Davis @ 2012-08-15 01:05 UTC (permalink / raw) To: Heikki Linnakangas <[email protected]>; +Cc: 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 ^ permalink raw reply [nested|flat] 4+ messages in thread
* Re: [DOCS] Confusion over "This page in other versions" links @ 2012-09-01 15:58 Bruce Momjian <[email protected]> parent: Jeff Davis <[email protected]> 0 siblings, 1 reply; 4+ messages in thread From: Bruce Momjian @ 2012-09-01 15:58 UTC (permalink / raw) To: Jeff Davis <[email protected]>; +Cc: Heikki Linnakangas <[email protected]>; PostgreSQL www <[email protected]> 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 <[email protected]> http://momjian.us EnterpriseDB http://enterprisedb.com + It's impossible for everything to be true. + ^ permalink raw reply [nested|flat] 4+ messages in thread
* Re: [DOCS] Confusion over "This page in other versions" links @ 2012-09-04 23:22 Josh Kupershmidt <[email protected]> parent: Bruce Momjian <[email protected]> 0 siblings, 0 replies; 4+ messages in thread From: Josh Kupershmidt @ 2012-09-04 23:22 UTC (permalink / raw) To: Bruce Momjian <[email protected]>; Jeff Davis <[email protected]>; +Cc: Heikki Linnakangas <[email protected]>; PostgreSQL www <[email protected]> On Sat, Sep 1, 2012 at 8:58 AM, Bruce Momjian <[email protected]> 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 ^ permalink raw reply [nested|flat] 4+ messages in thread
end of thread, other threads:[~2012-09-04 23:22 UTC | newest] Thread overview: 4+ messages (download: mbox mbox.gz follow: Atom feed) -- links below jump to the message on this page -- 2012-08-14 10:32 Confusion over "This page in other versions" links Heikki Linnakangas <[email protected]> 2012-08-15 01:05 ` Jeff Davis <[email protected]> 2012-09-01 15:58 ` Bruce Momjian <[email protected]> 2012-09-04 23:22 ` Josh Kupershmidt <[email protected]>
This inbox is served by agora; see mirroring instructions for how to clone and mirror all data and code used for this inbox