From: Tom Lane <tgl@sss.pgh.pa.us>
To: Jonathan S. Katz <jkatz@postgresql.org>
Cc: Niels Andersen <niels@thinkiq.com>
Cc: Bruce Momjian <bruce@momjian.us>
Cc: pgsql-docs@lists.postgresql.org <pgsql-docs@lists.postgresql.org>
Subject: Re: Version 13 documentation layout is harder to read than version 12
Date: Tue, 29 Sep 2020 15:28:50 -0400
Message-ID: <716231.1601407730@sss.pgh.pa.us> (raw)
In-Reply-To: <9ee29735-cd44-4795-c6dd-cf9f6c846a3d@postgresql.org>
References: <160135280918.659.8300614023795573502@wrigleys.postgresql.org>
<608344.1601387551@sss.pgh.pa.us>
<20200929151620.GA26841@momjian.us>
<BY5PR11MB4183B74112E32B2DC39A64B0A0320@BY5PR11MB4183.namprd11.prod.outlook.com>
<714873.1601406013@sss.pgh.pa.us>
<9ee29735-cd44-4795-c6dd-cf9f6c846a3d@postgresql.org>
"Jonathan S. Katz" <jkatz@postgresql.org> writes:
> On 9/29/20 3:00 PM, Tom Lane wrote:
>> But I think it's a net benefit for HTML output as well, in that the
>> output does adapt much better than before to smaller window sizes.
>> Not everybody wants to dedicate their whole screen to Postgres docs.
> I'll also note it helps on mobile viewing as well. We (likely the royal
> "we" in this case) still need to figure out some things with the font
> size on mobile to make it a bit easier to read, but the measurable
> readability of the tables in the v13 docs is better than v12 on smaller
> browsing windows.
See also Pavel's upthread complaint that the regular and monospace fonts
look too much alike. Personally I'm okay with the existing choices ---
they look enough different to me, on my browser. But I'll agree that it's
on the edge of being a problem. It might be worth taking another look at
that whenever someone does font fiddling.
> I would say on this particular page, the only thing I find slightly
> confusing is when the "->" operator is being described ("json -> integer
> -> json"), but I think that may just be an unfortunate happenstance and
> not grounds for redesign, at least at this time.
Yeah ... again, that's somewhat down to the font choices, IMO. The
rightarrow symbol is visibly different from ASCII "->", but not by
all that much. I'd prefer a bigger/thicker arrow for that, but
as far as I recall we couldn't find a portable way to render one.
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, jkatz@postgresql.org, niels@thinkiq.com, bruce@momjian.us, pgsql-docs@lists.postgresql.org
Subject: Re: Version 13 documentation layout is harder to read than version 12
In-Reply-To: <716231.1601407730@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