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 B8D230AC-898D-411A-B26E-7FBCDE1A896C@yesql.se
Whole thread Raw
In response to Re: [PATCH] Change text direction of documentation pages  ("Jonathan S. Katz" <jkatz@postgresql.org>)
Responses Re: [PATCH] Change text direction of documentation pages  ("Jonathan S. Katz" <jkatz@postgresql.org>)
List pgsql-www
> On 26 Nov 2021, at 16:09, Jonathan S. Katz <jkatz@postgresql.org> wrote:
>
> On 11/26/21 9:20 AM, Daniel Gustafsson wrote:
>
>> 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.
>
> In general this is the preferred way to handle titles for web pages from a SEO perspective (though that opens up a
differenttopic) 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 =)

> 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/




pgsql-www by date:

Previous
From: "Jonathan S. Katz"
Date:
Subject: Re: [PATCH] Change text direction of documentation pages
Next
From: Magnus Hagander
Date:
Subject: Re: [PATCH] pgarchives: Allow use of IP ranges for SEARCH_CLIENTS