Thread: Loss of boldface on syntax synopsis, v10 & devel
Web Team,
I don't recall this being mentioned before; I just noticed that in v9.6 and earlier docs the placeholders for identifiers/expressions/etc are boldfaced and italic. In v10 and devel they are just italic.
The boldface does seem to help improve readability for me.
David J.
Hi David,
On May 9, 2018, at 7:41 PM, David G. Johnston <david.g.johnston@gmail.com> wrote:Web Team,I don't recall this being mentioned before; I just noticed that in v9.6 and earlier docs the placeholders for identifiers/expressions/etc are boldfaced and italic. In v10 and devel they are just italic.The boldface does seem to help improve readability for me.
To clarify, you’re referring to something like the examples on this page:
AFAIK on the -www side we have not adjusted any of the styles so this is
a question for -docs in terms of what is being generated.
The difference I see code-wise:
10: <em class="replaceable"><code>query1</code></em>
9.5: <tt class="REPLACEABLE c2">query1</tt>
Thanks,
Jonathan
On 5/9/18 22:41, David G. Johnston wrote: > I don't recall this being mentioned before; I just noticed that in v9.6 > and earlier docs the placeholders for identifiers/expressions/etc are > boldfaced and italic. In v10 and devel they are just italic. > > The boldface does seem to help improve readability for me. They are meant to be italic only. I believe making replaceable text italic is a wide-spread convention. -- Peter Eisentraut http://www.2ndQuadrant.com/ PostgreSQL Development, 24x7 Support, Remote DBA, Training & Services
-----BEGIN PGP SIGNED MESSAGE----- Hash: RIPEMD160 Peter Eisentraut said re the v10 doc changes: > They are meant to be italic only. I believe making replaceable text > italic is a wide-spread convention. Convention or not, the new way looks (IMHO) much worse, as the keywords really blend in with the rest of the page. The older docs have a sharp, clear distinction that looks more professional. Compare: https://www.postgresql.org/docs/9.6/static/sql-altertable.html https://www.postgresql.org/docs/10/static/sql-altertable.html - -- Greg Sabino Mullane greg@turnstep.com PGP Key: 0x14964AC8 201805160906 http://biglumber.com/x/web?pk=2529DF6AB8F79407E94445B4BC9B906714964AC8 -----BEGIN PGP SIGNATURE----- iEYEAREDAAYFAlr8LS4ACgkQvJuQZxSWSsh0swCff2T6OXtWI9JT3IoqGHghYkLl lNUAoL/NAxwKqUmE8Gnr5nSZmQwgLaiP =s3/O -----END PGP SIGNATURE-----
On 05/16/2018 06:08 AM, Greg Sabino Mullane wrote: > > -----BEGIN PGP SIGNED MESSAGE----- > Hash: RIPEMD160 > > > Peter Eisentraut said re the v10 doc changes: > >> They are meant to be italic only. I believe making replaceable text >> italic is a wide-spread convention. > > Convention or not, the new way looks (IMHO) much worse, as the keywords > really blend in with the rest of the page. The older docs have a sharp, > clear distinction that looks more professional. Compare: > > https://www.postgresql.org/docs/9.6/static/sql-altertable.html > > https://www.postgresql.org/docs/10/static/sql-altertable.html +1 for bold. > > - -- > Greg Sabino Mullane greg@turnstep.com > PGP Key: 0x14964AC8 201805160906 > http://biglumber.com/x/web?pk=2529DF6AB8F79407E94445B4BC9B906714964AC8 > -- Adrian Klaver adrian.klaver@aklaver.com
On 2018-05-16 14:48, Adrian Klaver wrote: > On 05/16/2018 06:08 AM, Greg Sabino Mullane wrote: >> >> -----BEGIN PGP SIGNED MESSAGE----- >> Hash: RIPEMD160 >> >> >> Peter Eisentraut said re the v10 doc changes: >> >>> They are meant to be italic only. I believe making replaceable text >>> italic is a wide-spread convention. >> >> Convention or not, the new way looks (IMHO) much worse, as the >> keywords >> really blend in with the rest of the page. The older docs have a >> sharp, >> clear distinction that looks more professional. Compare: >> >> https://www.postgresql.org/docs/9.6/static/sql-altertable.html >> >> https://www.postgresql.org/docs/10/static/sql-altertable.html > > +1 for bold. Yeah. With my fairly standard (non HiDPI) LCD screens, the bold stands out much, much more, making things easier to grok. + Justin