[drupal-docs] deleting comments

[Djun Kim]

On 13 Jun 2005, at 9:18 PM, Anisa wrote:

> Comments make the handbook pages ugly.  If they contain useful info,
> they should be reintergrated into the handbook page itself, not left
> there forever.

Hmm.   I tend to agree, but...

There are a number of on-line manuals
which include user's comments in a very
helpful way... PHP.net, dev.mysql.com,
postgresql.org.   PHP.net is almost archetypical
for me - the user comments are often extremely
useful.

So, I guess there's some questions which
this leads us to.

Are the Handbook pages ugly because of the
way that they are  presented?   I.e., is it a matter
of design/layout?

Or is the problem with comments which are not
   - helpful
   - in context
   - current?

Are comments appropriate in some contexts
but not in others?

Are people using comments because it's
the only, or the easiest, way to
contribute content?



> Is anyone else interested in this?  One problem I run into when I try 
> to
> delete stuff is I can't tell if code snippets given are obselete or
> not.  What do I know, right?  I am thinking of writing up a project
> proposal for this, with established guidelines for deleting comments,
> commentable on by the community.
>
> Anisa.
>