Re: Version 13 documentation layout is harder to read than version 12 - Mailing list pgsql-docs

From Tom Lane
Subject Re: Version 13 documentation layout is harder to read than version 12
Date
Msg-id 608344.1601387551@sss.pgh.pa.us
Whole thread Raw
In response to Version 13 documentation layout is harder to read than version 12  (PG Doc comments form <noreply@postgresql.org>)
Responses Re: Version 13 documentation layout is harder to read than version 12
Re: Version 13 documentation layout is harder to read than version 12
List pgsql-docs
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



pgsql-docs by date:

Previous
From: PG Doc comments form
Date:
Subject: Version 13 documentation layout is harder to read than version 12
Next
From: Pavel Stehule
Date:
Subject: Re: Version 13 documentation layout is harder to read than version 12