> -----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])