Re: Update to docs root pages and navigation

From: Magnus Hagander <magnus(at)hagander(dot)net>
To: "David G(dot) Johnston" <david(dot)g(dot)johnston(at)gmail(dot)com>
Cc: Alvaro Herrera <alvherre(at)alvh(dot)no-ip(dot)org>, PostgreSQL WWW <pgsql-www(at)postgresql(dot)org>
Subject: Re: Update to docs root pages and navigation
Date: 2020-11-23 22:47:41
Message-ID: CABUevEzBB+F9kpcjOMjYy0j=HVgLWZAV1E53MQuJNhZCH2erGA@mail.gmail.com
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-www

On Mon, Nov 23, 2020 at 10:33 PM David G. Johnston
<david(dot)g(dot)johnston(at)gmail(dot)com> wrote:
>
> On Mon, Nov 23, 2020 at 2:24 PM Alvaro Herrera <alvherre(at)alvh(dot)no-ip(dot)org> wrote:
>>
>> On 2020-Nov-23, Magnus Hagander wrote:
>>
>> > I'm also attaching a screenshot of the main docs page with the
>> > changes, for those that can't easily test a website patch. (Nevermind
>> > the actual versions listed, as this is off a dev version of the
>> > database and not up to date)
>>
>> .. I find it a bit annoying that if I want the current docs, I have to
>> avoid looking at the table, or I'll get confused until I see the button
>> sitting above. IMO it would be better to include "13" in the table as
>> well as the button to avoid this effect (I realize this is redundant).
>>
>> Maybe if the button had red text that said "13" it would not be
>> necessary.
>>
>> Alternatively: remove the button, include "13" in the table, and have it
>> contain a blue tag-looking label that says "current" or something like
>> that. (While at it, and to make the current dev cycle less of an
>> exception: change the "Development version" row to have text "14dev" in
>> red plus a blue label that says "In development".)
>>
>
> FWIW I noticed this to, the re-read the email and noticed:
>
> "(Nevermind the actual versions listed, as this is off a dev version of the
> database and not up to date)"
>
> And figured the two were related.

That is indeed exactly what I was referring to :)

> An idea while I'm here - It is still a couple of clicks and screen searching to get to the current docs. How about an icon on the main page, next to the search icon (more useful for frequent users), that takes you immediately to the current documentation webpage? And/Or a third button in the banner (download, new?) for "Current Manual" (more useful for newer readers)?

Yeah, it makes sense to do something like that, I agree. I'll take a
look at that as a separate patch later, and post a separate proposal.

//Magnus

In response to

Browse pgsql-www by date

  From Date Subject
Next Message Magnus Hagander 2020-11-23 22:49:17 Re: Update to docs root pages and navigation
Previous Message David G. Johnston 2020-11-23 21:33:01 Re: Update to docs root pages and navigation