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

From Bruce Momjian
Subject Re: [DOCS] Doc fixes and improvements
Date
Msg-id 201009102053.o8AKrti17191@momjian.us
Whole thread Raw
In response to Re: [DOCS] Doc fixes and improvements  (Thom Brown <thom@linux.com>)
List pgsql-www
Thom Brown wrote:
> 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.

Looks much better. Here is "normal":
http://momjian.us/tmp/pg_manual4.png

and here is "Large":
http://momjian.us/tmp/pg_manual5.png

--  Bruce Momjian  <bruce@momjian.us>        http://momjian.us EnterpriseDB
http://enterprisedb.com
 + It's impossible for everything to be true. +


pgsql-www by date:

Previous
From: Thom Brown
Date:
Subject: Re: [DOCS] Doc fixes and improvements
Next
From: Tom Lane
Date:
Subject: Re: [DOCS] Doc fixes and improvements