In-Reply-To: <46670885.1050207@hagander.net>
References: <e431ff4c0706060910l4c79bf65ycc87cc617cd063f9@mail.gmail.com>
	<20070606164029.GB11800@alvh.no-ip.org>
	<46670885.1050207@hagander.net>
Mime-Version: 1.0 (Apple Message framework v752.3)
Content-Type: text/plain; charset=US-ASCII; delsp=yes; format=flowed
Message-Id: <74EDDCA2-5C8F-46D1-BC15-3C531BD66D3E@decibel.org>
Cc: Alvaro Herrera <alvherre@commandprompt.com>, nikolay@samokhvalov.com,
	pgsql-www@postgresql.org,
	PostgreSQL-documentation <pgsql-docs@postgresql.org>
Content-Transfer-Encoding: 7bit
From: Jim Nasby <decibel@decibel.org>
Subject: Re: [DOCS] Users comments don't migrate to docs for new version?
Date: Wed, 11 Jul 2007 12:49:44 -0500
To: Magnus Hagander <magnus@hagander.net>

On Jun 6, 2007, at 2:18 PM, Magnus Hagander wrote:
> Alvaro Herrera wrote:
>> Nikolay Samokhvalov wrote:
>>> I've just found (via google...) useful (for me) comments:
>>> http://www.postgresql.org/docs/8.0/interactive/sql- 
>>> createaggregate.html
>>> -- I mean users comments under primary contents of the page.
>>>
>>> These comments were written for 8.0, but are useful for the current
>>> versions too. What we have is the situation that reading docs for  
>>> 8.2
>>> people don't see these comments -- so this potentially useful
>>> information is lost. So, in this implementation the idea of comments
>>> for docs becomes weak in general.
>>
>> The thing to do in these cases is to move the useful info from the  
>> user
>> comments into the main doc text.
>
> Yeah, that's the idea. Tom often goes through the comments and puts
> stuff into the docs. But I'm sure there are a *lot* of other people  
> who
> could help with that as well - read comments, figure out of they make
> sense, and submit a docs patch for the next version!

It would be substantially easier to do that if there was an index  
page that listed all comments.
--
Jim Nasby                                            jim@nasby.net
EnterpriseDB      http://enterprisedb.com      512.569.9461 (cell)