public inbox for [email protected]
help / color / mirror / Atom feedConfusion 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]>
2012-08-15 01:05 ` Re: Confusion over "This page in other versions" links Jeff Davis <[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-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 ` Re: [DOCS] Confusion over "This page in other versions" links Bruce Momjian <[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-08-14 10:32 Confusion over "This page in other versions" links Heikki Linnakangas <[email protected]>
2012-08-15 01:05 ` Re: Confusion over "This page in other versions" links Jeff Davis <[email protected]>
@ 2012-09-01 15:58 ` Bruce Momjian <[email protected]>
2012-09-04 23:22 ` Re: [DOCS] Confusion over "This page in other versions" links Josh Kupershmidt <[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-08-14 10:32 Confusion over "This page in other versions" links Heikki Linnakangas <[email protected]>
2012-08-15 01:05 ` Re: Confusion over "This page in other versions" links Jeff Davis <[email protected]>
2012-09-01 15:58 ` Re: [DOCS] Confusion over "This page in other versions" links Bruce Momjian <[email protected]>
@ 2012-09-04 23:22 ` Josh Kupershmidt <[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