Skip site navigation (1) Skip section navigation (2)

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

From: Jim Nasby <decibel(at)decibel(dot)org>
To: Magnus Hagander <magnus(at)hagander(dot)net>
Cc: Alvaro Herrera <alvherre(at)commandprompt(dot)com>, nikolay(at)samokhvalov(dot)com, pgsql-www(at)postgresql(dot)org, PostgreSQL-documentation <pgsql-docs(at)postgresql(dot)org>
Subject: Re: [DOCS] Users comments don't migrate to docs for new version?
Date: 2007-07-11 17:49:44
Message-ID: 74EDDCA2-5C8F-46D1-BC15-3C531BD66D3E@decibel.org (view raw or flat)
Thread:
Lists: pgsql-docspgsql-www
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)



In response to

Responses

pgsql-docs by date

Next:From: Magnus HaganderDate: 2007-07-11 17:51:45
Subject: Re: [DOCS] Users comments don't migrate to docs for new version?
Previous:From: kenneth d'souzaDate: 2007-07-09 08:47:19
Subject: Locks and Waiters

pgsql-www by date

Next:From: Magnus HaganderDate: 2007-07-11 17:51:45
Subject: Re: [DOCS] Users comments don't migrate to docs for new version?
Previous:From: David FetterDate: 2007-07-11 16:36:37
Subject: Re: [pgsql-advocacy] Front page image

Privacy Policy | About PostgreSQL
Copyright © 1996-2014 The PostgreSQL Global Development Group