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

[Jim Nasby <decibel(at)decibel(dot)org>]

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(at)nasby(dot)net
EnterpriseDB      http://enterprisedb.com      512.569.9461 (cell)