From: | Bruce Momjian <bruce(at)momjian(dot)us> |
---|---|
To: | Thom Brown <thom(at)linux(dot)com> |
Cc: | Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us>, Magnus Hagander <magnus(at)hagander(dot)net>, PostgreSQL www <pgsql-www(at)postgresql(dot)org> |
Subject: | Re: [DOCS] Doc fixes and improvements |
Date: | 2010-09-10 20:53:55 |
Message-ID: | 201009102053.o8AKrti17191@momjian.us |
Views: | Raw Message | Whole Thread | Download mbox | Resend email |
Thread: | |
Lists: | pgsql-docs pgsql-www |
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. +
From | Date | Subject | |
---|---|---|---|
Next Message | Thom Brown | 2010-09-10 20:56:38 | Re: [DOCS] Doc fixes and improvements |
Previous Message | Thom Brown | 2010-09-10 20:47:06 | Re: [DOCS] Doc fixes and improvements |
From | Date | Subject | |
---|---|---|---|
Next Message | Thom Brown | 2010-09-10 20:56:38 | Re: [DOCS] Doc fixes and improvements |
Previous Message | Thom Brown | 2010-09-10 20:47:06 | Re: [DOCS] Doc fixes and improvements |