Re: collapsing of 'current' and 'latest released' version-specific links in docs

From: Andres Freund <andres(at)anarazel(dot)de>
To: Vik Fearing <vik(dot)fearing(at)2ndquadrant(dot)com>, Daniel Gustafsson <daniel(at)yesql(dot)se>
Cc: pgsql-www(at)postgresql(dot)org
Subject: Re: collapsing of 'current' and 'latest released' version-specific links in docs
Date: 2018-10-12 21:18:48
Message-ID: 20181012211848.zmxjbezf6rge4pde@alap3.anarazel.de
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-www

Hi,

On 2018-10-12 23:10:30 +0200, Vik Fearing wrote:
> On 12/10/18 23:01, Andres Freund wrote:
> > For a while now the "current" and "10" links have been merged in one
> > section, with either not being clickable when the other is selected.
> >
> > I don't think that's good. I very commonly want to give people links to
> > the *current* version of the docs (so if they bookmark it, they'll not
> > have a soon-to-be-out-of-date link). But a search might lead me to the
> > version specific page for 10. So then I've to navigate to some other
> > version, just to be able to click on the 'current' link. That's weird.
> >
> > Is that an intentional side-effect?
>
> https://www.postgresql.org/message-id/flat/63641a45-36fc-a8d2-69e4-e150cfbfa032%402ndquadrant.com

On 2017-07-09 23:13:55 +0200, Daniel Gustafsson wrote:
> > On 09 Jul 2017, at 15:47, Vik Fearing <vik(dot)fearing(at)2ndquadrant(dot)com> wrote:
> >
> > If I'm on a 9.4 page (random example), I can click on either "current"
> > or 9.6. But if I'm already on the 9.6 page, I can no longer click on
> > "current".
> >
> > As of this writing, those two pages are the same thing so it's not that
> > big a deal. But I specifically want the "current" link because that's
> > what I add to pg_docbot on irc.
>
> Wouldn’t such a link increase the risk of confusion for beginners regarding
> which version is the latest?

I don't find that convincing. For one, we do have both links - with
different targets! - clickable when on other versions. For another, as
long as they're both within the same / /, I don't see why it'd introduce
meaningfully more confusion.

Greetings,

Andres Freund

In response to

Responses

Browse pgsql-www by date

  From Date Subject
Next Message Daniel Gustafsson 2018-10-12 23:01:52 Re: collapsing of 'current' and 'latest released' version-specific links in docs
Previous Message Jonathan S. Katz 2018-10-12 21:13:19 Re: collapsing of 'current' and 'latest released' version-specific links in docs