Re: Interactive Documentation - how do you want it to - Mailing list pgsql-hackers

From Neil Conway
Subject Re: Interactive Documentation - how do you want it to
Date
Msg-id 1044219100.25208.29.camel@tokyo
Whole thread Raw
In response to Interactive Documentation - how do you want it to work?  ("Dave Page" <dpage@vale-housing.co.uk>)
Responses Re: Interactive Documentation - how do you want it to
List pgsql-hackers
On Sun, 2003-02-02 at 15:22, Dave Page wrote:
>  - Each comment attaches only to the page name, version of the page to
> which it was submitted *and* subsequent versions (this is the current
> behaviour).
> 
>  - Each comment should attach to the page name to which it was submitted
> regardless of the version.

IMHO either one of these, considering below...

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

Cheers,

Neil
-- 
Neil Conway <neilc@samurai.com> || PGP Key ID: DB3C29FC





pgsql-hackers by date:

Previous
From: Tom Lane
Date:
Subject: Re: Last call for 7.3.2
Next
From: Josh Berkus
Date:
Subject: Re: [PERFORM] not using index for select min(...)