[drupal-docs] comments in handbook

Boris Mann borismann at gmail.com
Wed Dec 15 03:48:21 UTC 2004


On Tue, 14 Dec 2004 13:46:12 +0100, Bèr Kessels <berdrupal at tiscali.be> wrote:
 
> I think we also need to agree on a general rule for commenting to the
> handbooks.
> too often the comments are old, talking about problems that no longer exist,
> or are even plain support requests.

I agree with everything that you say here, Ber. I like the comments in
the PHP.net manual -- different ways of doing things, specific
questions/answers on how to do X, etc.

Should we delete comments outright? (sometimes) How do we
contact/notify the comment poster? (pointing them to forums/project
issues/etc.) Maybe we should even just turn comments off for book
pages?

Aside: I realize comments aren't the right place for this, but how do
we do "meta" comments, to discuss the wording/content of manual pages?

Aside #2: it would be great to have comment approval *just* for books.
This is something else we might want to think about in re-vamping
default workflow.

--
Boris Mann
http://www.bryght.com



More information about the drupal-docs mailing list