Message-ID: <46670885.1050207@hagander.net>
Date: Wed, 06 Jun 2007 21:18:29 +0200
From: Magnus Hagander <magnus@hagander.net>
User-Agent: Thunderbird 2.0.0.5pre (Windows/20070606)
MIME-Version: 1.0
To: Alvaro Herrera <alvherre@commandprompt.com>
CC: nikolay@samokhvalov.com,  pgsql-www@postgresql.org,
	PostgreSQL-documentation <pgsql-docs@postgresql.org>
Subject: Re: [DOCS] Users comments don't migrate to docs for new
 version?
References: <e431ff4c0706060910l4c79bf65ycc87cc617cd063f9@mail.gmail.com>
	<20070606164029.GB11800@alvh.no-ip.org>
In-Reply-To: <20070606164029.GB11800@alvh.no-ip.org>
Content-Type: text/plain; charset=ISO-8859-1
Content-Transfer-Encoding: 7bit

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!

//Magnus