Re: [DOCS] Doc fixes and improvements

On 10 September 2010 21:25, Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us> wrote:
> Thom Brown <thom(at)linux(dot)com> writes:
>> On 10 September 2010 21:05, Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us> wrote:
>>> You know, I hate to say it, but this is just way too busy for my taste.
>>> The typography is screaming "look at me" instead of staying out of the
>>> way.  I can't imagine wanting to read any large amount of docs in this
>>> presentation.
>>>
>>> Maybe I'm in the minority.
>
>> Do you have any specific recommendations?  What would tone it down?
>
> 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.

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

Lighter example boxes, slightly smaller monospace and no bold
monospace text within paragraphs on the page.

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

--
Thom Brown
Twitter: @darkixion
IRC (freenode): dark_ixion
Registered Linux user: #516935