From: | Thom Brown <thom(at)linux(dot)com> |
---|---|
To: | Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us> |
Cc: | Magnus Hagander <magnus(at)hagander(dot)net>, Bruce Momjian <bruce(at)momjian(dot)us>, PostgreSQL www <pgsql-www(at)postgresql(dot)org> |
Subject: | Re: [DOCS] Doc fixes and improvements |
Date: | 2010-09-10 20:47:06 |
Message-ID: | AANLkTikL_38dMk1ge3pynOKTp0TciYyyVr4+d_Qdbp3E@mail.gmail.com |
Views: | Raw Message | Whole Thread | Download mbox | Resend email |
Thread: | |
Lists: | pgsql-docs pgsql-www |
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.
--
Thom Brown
Twitter: @darkixion
IRC (freenode): dark_ixion
Registered Linux user: #516935
From | Date | Subject | |
---|---|---|---|
Next Message | Bruce Momjian | 2010-09-10 20:53:55 | Re: [DOCS] Doc fixes and improvements |
Previous Message | Joshua D. Drake | 2010-09-10 20:46:12 | Re: [DOCS] Doc fixes and improvements |
From | Date | Subject | |
---|---|---|---|
Next Message | Bruce Momjian | 2010-09-10 20:53:55 | Re: [DOCS] Doc fixes and improvements |
Previous Message | Joshua D. Drake | 2010-09-10 20:46:12 | Re: [DOCS] Doc fixes and improvements |