Received: from malur.postgresql.org ([217.196.149.56])
	by arkaria.postgresql.org with esmtps
 (TLS1.3:ECDHE_RSA_AES_256_GCM_SHA384:256)
	(Exim 4.92)
	(envelope-from <pgsql-www-owner+archive@lists.postgresql.org>)
	id 1mrcmO-00057Y-HS
	for pgsql-www@arkaria.postgresql.org; Mon, 29 Nov 2021 09:16:56 +0000
Received: from localhost ([127.0.0.1] helo=malur.postgresql.org)
	by malur.postgresql.org with esmtp (Exim 4.92)
	(envelope-from <pgsql-www-owner+archive@lists.postgresql.org>)
	id 1mrcmN-0007IG-5K
	for pgsql-www@arkaria.postgresql.org; Mon, 29 Nov 2021 09:16:55 +0000
Received: from makus.postgresql.org ([2001:4800:3e1:1::229])
	by malur.postgresql.org with esmtps (TLS1.3:ECDHE_RSA_AES_256_GCM_SHA384:256)
	(Exim 4.92)
	(envelope-from <daniel@yesql.se>)
	id 1mrcmM-0007I7-Un
	for pgsql-www@lists.postgresql.org; Mon, 29 Nov 2021 09:16:54 +0000
Received: from smtp.outgoing.loopia.se ([93.188.3.37])
	by makus.postgresql.org with esmtps (TLS1.3:ECDHE_RSA_AES_256_GCM_SHA384:256)
	(Exim 4.92)
	(envelope-from <daniel@yesql.se>)
	id 1mrcmJ-0001w3-Se
	for pgsql-www@lists.postgresql.org; Mon, 29 Nov 2021 09:16:53 +0000
Received: from s807.loopia.se (localhost [127.0.0.1])
	by s807.loopia.se (Postfix) with ESMTP id 8AB072F074DB
	for <pgsql-www@lists.postgresql.org>; Mon, 29 Nov 2021 10:16:43 +0100 (CET)
Received: from s899.loopia.se (unknown [172.22.191.5])
	by s807.loopia.se (Postfix) with ESMTP id 78F282E2AD21;
	Mon, 29 Nov 2021 10:16:43 +0100 (CET)
Received: from s475.loopia.se (unknown [172.22.191.6])
	by s899.loopia.se (Postfix) with ESMTP id 72D6F2C91C10;
	Mon, 29 Nov 2021 10:16:43 +0100 (CET)
X-Virus-Scanned: amavisd-new at amavis.loopia.se
X-Spam-Flag: NO
X-Spam-Score: -1
X-Spam-Level: 
X-Spam-Status: No, score=-1 tagged_above=-999 required=6.2
	tests=[ALL_TRUSTED=-1] autolearn=disabled
Received: from s645.loopia.se ([172.22.191.6])
	by s475.loopia.se (s475.loopia.se [172.22.190.15]) (amavisd-new, port 10024)
	with LMTP id P_6zQELKYXQ5; Mon, 29 Nov 2021 10:16:43 +0100 (CET)
X-Loopia-Auth: user
X-Loopia-User: daniel@yesql.se
X-Loopia-Originating-IP: 89.255.232.193
Received: from [192.168.72.144] (customer-89-255-232-193.stosn.net
 [89.255.232.193])
	(Authenticated sender: daniel@yesql.se)
	by s645.loopia.se (Postfix) with ESMTPSA id 9A9441570499;
	Mon, 29 Nov 2021 10:16:42 +0100 (CET)
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: <31a6c019-83ef-2d12-b9c7-3829ee7977bf@postgresql.org>
Date: Mon, 29 Nov 2021 10:16:42 +0100
Cc: Magnus Hagander <magnus@hagander.net>,
 Nils <nils@nilsand.re>,
 pgsql-www@lists.postgresql.org
Content-Transfer-Encoding: quoted-printable
Message-Id: <B8D230AC-898D-411A-B26E-7FBCDE1A896C@yesql.se>
References: <20211107163140.rnqihhpwrc5vwt2l@nixos>
 <CABUevEw+Trc7vnb=nH-_qQqQVg7qwwNsNrf_RFf6VmrqywwF8A@mail.gmail.com>
 <53D92024-85B0-4226-82A4-3A27CFA7880B@yesql.se>
 <31a6c019-83ef-2d12-b9c7-3829ee7977bf@postgresql.org>
To: "Jonathan S. Katz" <jkatz@postgresql.org>
X-Mailer: Apple Mail (2.3608.120.23.2.7)
List-Id: <pgsql-www.lists.postgresql.org>
List-Help: <https://lists.postgresql.org/manage/>
List-Subscribe: <https://lists.postgresql.org/manage/>
List-Post: <mailto:pgsql-www@lists.postgresql.org>
List-Owner: <mailto:pgsql-www-owner@lists.postgresql.org>
List-Archive: <https://www.postgresql.org/list/pgsql-www>
Archived-At: 
 <https://www.postgresql.org/message-id/B8D230AC-898D-411A-B26E-7FBCDE1A896C%40yesql.se>
Precedence: bulk

> On 26 Nov 2021, at 16:09, Jonathan S. Katz <jkatz@postgresql.org> =
wrote:
>=20
> On 11/26/21 9:20 AM, Daniel Gustafsson wrote:
>=20
>> 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.
>=20
> In general this is the preferred way to handle titles for web pages =
from a SEO perspective (though that opens up a different topic) and I've =
typically seen it done with a "|".

Looking at the docs pages on *.readthedocs.io, python.org, =
perldoc.perl.org,
rust-lang.org and php.net they all use variations of the dash, =
kubernetes.io
uses a pipe.  I doubt that the choice of separator character (among =
commonly
used such separators) will play a huge role in SEO - but that being =
said, if I
Google "postgresql timestamp data type" the top hit is the 9.1 docs so =
maybe we
should just not care about SEO at all =3D)

> Overall OK with the approach, but would like to see how it renders.

I don't have a local pgweb setup for now, so feel free to pick it up and =
play
with it if you have time.

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