Re: [DOCS] Doc fixes and improvements - Mailing list pgsql-www

From Thom Brown
Subject Re: [DOCS] Doc fixes and improvements
Date
Msg-id AANLkTikL_38dMk1ge3pynOKTp0TciYyyVr4+d_Qdbp3E@mail.gmail.com
Whole thread Raw
In response to Re: [DOCS] Doc fixes and improvements  (Tom Lane <tgl@sss.pgh.pa.us>)
Responses Re: [DOCS] Doc fixes and improvements
Re: [DOCS] Doc fixes and improvements
List pgsql-www
On 10 September 2010 21:25, Tom Lane <tgl@sss.pgh.pa.us> wrote:
> Thom Brown <thom@linux.com> writes:
>> On 10 September 2010 21:05, Tom Lane <tgl@sss.pgh.pa.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


pgsql-www by date:

Previous
From: "Joshua D. Drake"
Date:
Subject: Re: [DOCS] Doc fixes and improvements
Next
From: Bruce Momjian
Date:
Subject: Re: [DOCS] Doc fixes and improvements