From: Tom Lane <tgl@sss.pgh.pa.us>
To: Pavel Stehule <pavel.stehule@gmail.com>
Cc: niels@thinkiq.com, Pg Docs <pgsql-docs@lists.postgresql.org>
Subject: Re: Version 13 documentation layout is harder to read than version 12
Date: Tue, 29 Sep 2020 10:29:19 -0400
Message-ID: <609803.1601389759@sss.pgh.pa.us> (raw)
In-Reply-To: <CAFj8pRDHAX262QS=6X0wNDru1pWYQNFeDwXPnU0gex+b0cPfAg@mail.gmail.com>
References: <160135280918.659.8300614023795573502@wrigleys.postgresql.org>
<608344.1601387551@sss.pgh.pa.us>
<CAFj8pRDHAX262QS=6X0wNDru1pWYQNFeDwXPnU0gex+b0cPfAg@mail.gmail.com>
Pavel Stehule <pavel.stehule@gmail.com> writes:
> the new layout is probably better, but I miss some gentle separation of
> these three parts - maybe using a different font?
Hm? If you mean synopsis vs. description vs. examples, the description
already is a different font from the other two.
I recall that we did experiment with extra vertical whitespace to
separate, but abandoned that, possibly because controlling it was too
painful with DocBook.
regards, tom lane
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: tgl@sss.pgh.pa.us, pavel.stehule@gmail.com, pgsql-docs@lists.postgresql.org
Subject: Re: Version 13 documentation layout is harder to read than version 12
In-Reply-To: <609803.1601389759@sss.pgh.pa.us>
* 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