Re: [pgsql-www] Users comments don't migrate to docs for new version? - Mailing list pgsql-docs

From Magnus Hagander
Subject Re: [pgsql-www] Users comments don't migrate to docs for new version?
Date
Msg-id 46670885.1050207@hagander.net
Whole thread Raw
In response to Re: [pgsql-www] Users comments don't migrate to docs for new version?  (Alvaro Herrera <alvherre@commandprompt.com>)
Responses Re: [pgsql-www] Users comments don't migrate to docs for new version?  (Alvaro Herrera <alvherre@commandprompt.com>)
Re: [pgsql-www] Users comments don't migrate to docs for new version?  (David Fetter <david@fetter.org>)
Re: [pgsql-www] Users comments don't migrate to docs for new version?  (Jim Nasby <decibel@decibel.org>)
List pgsql-docs
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

pgsql-docs by date:

Previous
From: "Christian Rossow"
Date:
Subject: Probably mistake in Arrays docs & proposal for index
Next
From: Alvaro Herrera
Date:
Subject: Re: [pgsql-www] Users comments don't migrate to docs for new version?