Re: [PATCH] Change text direction of documentation pages - Mailing list pgsql-www

From Daniel Gustafsson
Subject Re: [PATCH] Change text direction of documentation pages
Date
Msg-id 53D92024-85B0-4226-82A4-3A27CFA7880B@yesql.se
Whole thread Raw
In response to Re: [PATCH] Change text direction of documentation pages  (Magnus Hagander <magnus@hagander.net>)
Responses Re: [PATCH] Change text direction of documentation pages  ("Jonathan S. Katz" <jkatz@postgresql.org>)
List pgsql-www
> On 24 Nov 2021, at 14:58, Magnus Hagander <magnus@hagander.net> wrote:
> On Sun, Nov 7, 2021 at 5:31 PM Nils <nils@nilsand.re <mailto:nils@nilsand.re>> wrote:
> This makes the browser (tested on Firefox and Chrome. This does not
> apply to Safari because it uses (what seems to be) heuristics to remove
> generic information from the title and the title is displayed centered)
> display the title right aligned in the tab bar allowing users to see
> which page they are on, instead of only the beginning of the title being
> visible, preventing switching between different documentation tabs
> quickly.
>
> This change was not generalised to other pages as the need is smaller on
> other pages. For example on the home page, seeing "...open source
> database" is not better than seeing "PostgreSQL: The world's...".
>
> Interesting -- I had no idea this could be done :)

Ditto.

> Thinking about it. I agree with the comment about the home page, but I wonder if that is the *only* case where it
actuallymakes sense the way it is now, and that *all* other pages would be better off with this switch? 
>
> Can you (or someone else) think of another counterexample?

Looking at the precedent set by other documentation sites, I think we should do
the simpler fix of reversing the order of elements in the title tag like the
(untested) below:

-  <title>PostgreSQL: Documentation: {{page.display_version}}: {{page.title}}</title>
+  <title>{{page.title}} — PostgreSQL {{page.display_version}} Documentation</title>

This will also work in all browsers and across all types of devices.

Shifting the order probably applies to more pages, but I agree that the docs
are especially interesting to tackle first.

--
Daniel Gustafsson        https://vmware.com/




pgsql-www by date:

Previous
From: Tom Lane
Date:
Subject: Re: Expired cert
Next
From: "Jonathan S. Katz"
Date:
Subject: Re: [PATCH] Change text direction of documentation pages