Content-Type: text/plain;
	charset=us-ascii
Mime-Version: 1.0 (Mac OS X Mail 13.4 \(3608.120.23.2.7\))
Subject: Re: [PATCH] Change text direction of documentation pages
From: Daniel Gustafsson <daniel@yesql.se>
In-Reply-To: 
 <CABUevEw+Trc7vnb=nH-_qQqQVg7qwwNsNrf_RFf6VmrqywwF8A@mail.gmail.com>
Date: Fri, 26 Nov 2021 15:20:57 +0100
Cc: Nils <nils@nilsand.re>,
 pgsql-www@lists.postgresql.org
Content-Transfer-Encoding: quoted-printable
Message-Id: <53D92024-85B0-4226-82A4-3A27CFA7880B@yesql.se>
References: <20211107163140.rnqihhpwrc5vwt2l@nixos>
 <CABUevEw+Trc7vnb=nH-_qQqQVg7qwwNsNrf_RFf6VmrqywwF8A@mail.gmail.com>
To: Magnus Hagander <magnus@hagander.net>
Archived-At: 
 <https://www.postgresql.org/message-id/53D92024-85B0-4226-82A4-3A27CFA7880B%40yesql.se>
Precedence: bulk

> 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.
>=20
> 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...".
>=20
> 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 actually makes sense the way =
it is now, and that *all* other pages would be better off with this =
switch?
>=20
> 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}} &mdash; 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/