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

From Selena Deckelmann
Subject Re: [DOCS] Doc fixes and improvements
Date
Msg-id AANLkTimLTDZJLDDOPFbWihRLroFEu5wS8dwa7wPP1hM=@mail.gmail.com
Whole thread Raw
In response to Re: [DOCS] Doc fixes and improvements  (Robert Haas <robertmhaas@gmail.com>)
List pgsql-www
On Tue, Sep 14, 2010 at 9:37 AM, Robert Haas <robertmhaas@gmail.com> wrote:
> On Tue, Sep 14, 2010 at 12:29 PM, Thom Brown <thom@linux.com> wrote:
>> On 14 September 2010 17:16, Robert Haas <robertmhaas@gmail.com> wrote:
>>> On Tue, Sep 14, 2010 at 9:58 AM, Thom Brown <thom@linux.com> wrote:
>>>> I think a consensus needs to be reached on what you guys want
>>>> changing.  Implementing changes isn't a problem, it's what changes
>>>> should be implemented.  Whatever is decided, it needs to be easy to
>>>> visually scan the page and its sections, clean and consistent.
>>>
>>> It seems like you're giving up just when we've just about got
>>> consensus.  Please don't.
>>
>> No, not at all.  :)  I'm just suggesting that rather than people
>> making a suggestion, and me going ahead and putting that change in
>> straight away (like I have been doing), it should have the support of
>> more than a single person first, otherwise there'll be lots of
>> tweaking and un-tweaking without any real agreement.
>>
>> If you wish to go ahead with what we've currently got, I'll create
>> another patch for Magnus to stage, otherwise what requires changing
>> needs to be decided.
>
> Oh, OK.  Well, +1 for pushing live what's currently at:
>
> http://pgweb.darkixion.com:8081/docs/8.4/static/sql-syntax-lexical.html
>
> It's probably not perfect, but I think it's better than what we have
> now, and that's sufficient.  Damn the torpedoes, full speed ahead.

+1

Thanks, Thom, for putting the time and energy into this. It's lovely to see.

I've been following along, and I think what we have now is a very nice
improvement. Once it is pushed live, I recommend publishing a blog
post and soliciting feedback about the changes. Not necessarily to
change anything right away, but just to collect feedback.

-selena

--
http://chesnok.com/daily - me


pgsql-www by date:

Previous
From: Dave Page
Date:
Subject: Re: [DOCS] Doc fixes and improvements
Next
From: "Joshua D. Drake"
Date:
Subject: Re: [DOCS] Doc fixes and improvements