Re: [DOCS] [pgsql-www] Users comments don't migrate to docs for new version?
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[EMAIL PROTECTED] EnterpriseDB http://enterprisedb.com 512.569.9461 (cell) ---(end of broadcast)--- TIP 1: if posting/reading through Usenet, please send an appropriate subscribe-nomail command to [EMAIL PROTECTED] so that your message can get through to the mailing list cleanly
Re: [DOCS] [pgsql-www] Users comments don't migrate to docs for new version?
Jim Nasby wrote: > 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. There is supposed to be one in the admin interface. But it seems I broke that with the latest update :-) Are you volunteering for doing some work on it? If so, I'm going to increase the priority of fixing that :-) //Magnus ---(end of broadcast)--- TIP 3: Have you checked our extensive FAQ? http://www.postgresql.org/docs/faq
