public inbox for [email protected]  

help / color / mirror / Atom feed

From: Jim Nasby <[email protected]>
To: Magnus Hagander <[email protected]>
Cc: Alvaro Herrera <[email protected]>
Cc: [email protected]
Cc: [email protected]
Cc: PostgreSQL-documentation <[email protected]>
Subject: Re: [DOCS] Users comments don't migrate to docs for new version?
Date: Wed, 11 Jul 2007 12:49:44 -0500
Message-ID: <[email protected]> (raw)
In-Reply-To: <[email protected]>
References: <[email protected]>
	<[email protected]>
	<[email protected]>

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)

view thread (14+ messages)  latest in thread

reply

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Reply to all the recipients using the --to and --cc options:
  reply via email

  To: [email protected]
  Cc: [email protected], [email protected], [email protected], [email protected], [email protected]
  Subject: Re: [DOCS] Users comments don't migrate to docs for new version?
  In-Reply-To: <[email protected]>

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

This inbox is served by agora; see mirroring instructions
for how to clone and mirror all data and code used for this inbox