Re: [DOCS] Doc fixes and improvements

Thom Brown <thom@linux.com> writes:
> On 10 September 2010 21:25, Tom Lane <tgl@sss.pgh.pa.us> wrote:
>> I still think the colored backgrounds are overused, and there's way too
>> much bold text. �AFAICS all the fixed-width-font text is now bold too,
>> to no improvement in readability.

> The fixed-width-font text in examples shouldn't appear bold as I've
> applied no such style to those.

Hmm.  I'm seeing nothing but boldface on Magnus' pages, using Safari.

> How about this:
> http://pgweb.darkixion.com:8081/docs/8.4/static/sql-syntax-lexical.html

Curiously, that *doesn't* show as bold.

> The intention of making a clear visual distinction between normal
> paragraph sections and examples/output was to make it easier to scan.

Agreed, but a little goes a long way.  If you overdo it, it'll grate on
the reader after twenty or thirty pages.  The example blocks on this
page are suitably subtle, maybe even a bit too far --- I find that
depending on what angle I look at my LCD display, the background color
can be practically indistinguishable from the rest of the page.  But
at other angles there's a clear distinction.
        regards, tom lane