> -----Original Message-----
> From: Neil Conway [mailto:[EMAIL PROTECTED]] 
> Sent: 02 February 2003 20:52
> To: Dave Page
> Cc: PostgreSQL Hackers
> Subject: Re: [HACKERS] Interactive Documentation - how do you 
> want it towork?
> > 2) Bearing in mind your answer to the previous question, should all 
> > the comments be deleted when useful examples have been 
> merged into the 
> > main documents (remember that the definition of 'useful' 
> may vary), or 
> > should we only remove the 'junk' ones?
> Once the comment's suggestion has been incorporated and the 
> docs updated, I think it should be removed. Just like in the 
> rest of the documentation, there's no point presenting 
> duplicate content to the user, so we should only keep the 
> idocs comments that are still relevant. The same goes for 
> comments that have no value (e.g. support requests).

My concern here is that what (for example) Bruce decides is not a useful
addition to the docs themselves, maybe something that would have helped
me with some bizarre problem. If we dump *all* the docs after they have
been merged then I might lose that helpful tip.

Also, and perhaps more importantly, the comments will be merged into a
*future* version. If I am running 7.2, I'm going to look at the 7.2
docs, not 7.3.

Regards, Dave.

---------------------------(end of broadcast)---------------------------
TIP 2: you can get off all lists at once with the unregister command
    (send "unregister YourEmailAddressHere" to [EMAIL PROTECTED])

Reply via email to