Re: [DOCS] Doc fixes and improvements

Thom Brown wrote:
> 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.

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(at)momjian(dot)us> http://momjian.us
EnterpriseDB http://enterprisedb.com

+ It's impossible for everything to be true. +