From: Jonathan S. Katz <jkatz@postgresql.org>
To: Niels Bom <niels@nielsbom.com>
To: pgsql-docs@lists.postgresql.org
Subject: Re: Usability ideas: text width and headers that are links
Date: Fri, 21 Oct 2022 11:42:08 -0400
Message-ID: <283a08f1-ae00-8a96-db7c-dbd43bb53aae@postgresql.org> (raw)
In-Reply-To: <e6f470fa-030e-41cc-9326-010b8081f75e@app.fastmail.com>
References: <e6f470fa-030e-41cc-9326-010b8081f75e@app.fastmail.com>
Hi,
Thanks for the suggestions. Comments inline:
On 10/21/22 9:54 AM, Niels Bom wrote:
> Hi!
>
> I have 2 small ideas to improve the usability of the PostgreSQL documentation. I'm looking at v15 (1) mostly.
>
> Idea 1:
> Give the text width of the main content a max width.
Why? Can you please provide examples? Screenshots are OK.
> Idea 2:
> Each h3 and h4 element should be a link pointing to the nearest parent section with an id. This makes deeplinking to specific parts of a page easier. This prevents people from having to scroll to the top, find out which table-of-content-link they have to click to get the deeplink of where they wanted to link. This is actually quite a common pattern. See the Python docs (2) and the Mozilla docs (3) as examples. The pattern on those sites is even a little nicer by showing an icon on hover.
This has been on my backlog for awhile, i.e. to have the hovering
"anchor holders". I'll try to move it up on the list.
Thanks,
Jonathan
Attachments:
[application/pgp-signature] OpenPGP_signature (839B, ../283a08f1-ae00-8a96-db7c-dbd43bb53aae@postgresql.org/2-OpenPGP_signature)
download
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Reply to all the recipients using the --to and --cc options:
reply via email
To: pgsql-docs@postgresql.org
Cc: jkatz@postgresql.org, niels@nielsbom.com, pgsql-docs@lists.postgresql.org
Subject: Re: Usability ideas: text width and headers that are links
In-Reply-To: <283a08f1-ae00-8a96-db7c-dbd43bb53aae@postgresql.org>
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
This inbox is served by DDX for PostgreSQL; see mirroring instructions
for how to clone and mirror all data and code used for this inbox