From: Bruce Momjian <bruce@momjian.us>
Message-Id: <201009102053.o8AKrti17191@momjian.us>
Subject: Re: [DOCS] Doc fixes and improvements
In-Reply-To: <AANLkTikL_38dMk1ge3pynOKTp0TciYyyVr4+d_Qdbp3E@mail.gmail.com>
To: Thom Brown <thom@linux.com>
Date: Fri, 10 Sep 2010 16:53:55 -0400 (EDT)
CC: Tom Lane <tgl@sss.pgh.pa.us>, Magnus Hagander <magnus@hagander.net>,
	PostgreSQL www <pgsql-www@postgresql.org>
MIME-Version: 1.0
Content-Transfer-Encoding: 7bit
Content-Type: text/plain; charset="US-ASCII"

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. +