Loss of boldface on syntax synopsis, v10 & devel

Next Topic
 
classic Classic list List threaded Threaded
6 messages Options
Reply | Threaded
Open this post in threaded view
|

Loss of boldface on syntax synopsis, v10 & devel

David G Johnston
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.

Reply | Threaded
Open this post in threaded view
|

Re: Loss of boldface on syntax synopsis, v10 & devel

Jonathan S. Katz-3
Hi David,

On May 9, 2018, at 7:41 PM, David G. Johnston <[hidden email]> 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
Reply | Threaded
Open this post in threaded view
|

Re: Loss of boldface on syntax synopsis, v10 & devel

Peter Eisentraut-6
In reply to this post by David G Johnston
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

Reply | Threaded
Open this post in threaded view
|

Re: Loss of boldface on syntax synopsis, v10 & devel

Greg Sabino Mullane

-----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 [hidden email]
PGP Key: 0x14964AC8 201805160906
http://biglumber.com/x/web?pk=2529DF6AB8F79407E94445B4BC9B906714964AC8

-----BEGIN PGP SIGNATURE-----

iEYEAREDAAYFAlr8LS4ACgkQvJuQZxSWSsh0swCff2T6OXtWI9JT3IoqGHghYkLl
lNUAoL/NAxwKqUmE8Gnr5nSZmQwgLaiP
=s3/O
-----END PGP SIGNATURE-----



Reply | Threaded
Open this post in threaded view
|

Re: Loss of boldface on syntax synopsis, v10 & devel

Adrian Klaver-4
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 [hidden email]
> PGP Key: 0x14964AC8 201805160906
> http://biglumber.com/x/web?pk=2529DF6AB8F79407E94445B4BC9B906714964AC8
>

--
Adrian Klaver
[hidden email]

Reply | Threaded
Open this post in threaded view
|

Re: Loss of boldface on syntax synopsis, v10 & devel

Justin Clift-2
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

Next Thread