From: Tom Lane <tgl@sss.pgh.pa.us>
To: niels@thinkiq.com
Cc: pgsql-docs@lists.postgresql.org
Subject: Re: Version 13 documentation layout is harder to read than version 12
Date: Tue, 29 Sep 2020 09:52:31 -0400
Message-ID: <608344.1601387551@sss.pgh.pa.us> (raw)
In-Reply-To: <160135280918.659.8300614023795573502@wrigleys.postgresql.org>
References: <160135280918.659.8300614023795573502@wrigleys.postgresql.org>
PG Doc comments form <noreply@postgresql.org> writes:
> Compare:
> * https://www.postgresql.org/docs/13/functions-json.html
> * https://www.postgresql.org/docs/12/functions-json.html> I know it is just my opinion, but the version 12 layout is easier to read
> than version 13.
IMO, table 9.47 (JSON Processing Functions) is pretty much the poster
child for why we had to redesign the table layout. In the old layout,
it's close to unreadable in any normal-size browser window, despite
wasting lots of whitespace and having large amounts of important info
shuffled off into "Note" blocks. The new layout is far more adaptable
to viewing windows that aren't full-screen-width; and the "Note" text has
all been merged into the table, so that you don't have to scroll down and
back to find all the info about a function.
I'll concede that it's a bit of a shock at first if you are used to the
old layout. But the developer community has been looking at this format
for six months or so now, and I think people grew accustomed to it fairly
quickly.
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, niels@thinkiq.com, pgsql-docs@lists.postgresql.org
Subject: Re: Version 13 documentation layout is harder to read than version 12
In-Reply-To: <608344.1601387551@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