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

From Thom Brown
Subject Re: [DOCS] Doc fixes and improvements
Date
Msg-id AANLkTikize2LqF6UOa6Nhn9dxWFYbqOidw_zjJASj8Mn@mail.gmail.com
Whole thread Raw
In response to Re: [DOCS] Doc fixes and improvements  (Bruce Momjian <bruce@momjian.us>)
Responses Re: [DOCS] Doc fixes and improvements
List pgsql-www
On 11 September 2010 22:10, Bruce Momjian <bruce@momjian.us> wrote:
> Robert Haas wrote:
>> On Fri, Sep 10, 2010 at 4:25 PM, 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.
>>
>> It's way too much boldface for my taste, too.  I am not sure I agree
>> that the colored backgrounds are overused.
>
> I think you should look at Thom's version, which is more current:
>
>        http://pgweb.darkixion.com:8081/docs/8.4/static/sql-syntax-lexical.html

Right, I've had a moment to made some changes.  I've tweaked the
javascript and went with the != comparison and   changes.  Also I
think I *was* mistaken with not introducing bold for a set of
keywords.  Obviously I sneaked that in at some point to see how it
would look but didn't recall doing so.

So the latest changes are on my version (like your link above) again.
Have I missed anyone's existing recommendations out?  How's it look in
Konqueror?  I think it does look less brash than before; I think Tom
was right that it was too in-your-face.  Does it need toning down
more?  Other suggestions?

--
Thom Brown
Twitter: @darkixion
IRC (freenode): dark_ixion
Registered Linux user: #516935


pgsql-www by date:

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