[drupal-docs] deleting comments

[Anisa]

I don't really know about all those other sites. ^.^  If the comments 
contain useful information, it's usually because they're either trying 
to fill in a gap in the handbook, or trying to answer a support question 
that should've been posted in the forum. 

It's not really a design question so much as well, it's like having a 
textbook that's brand new but full of mistakes and omissions that 
someone has fixed by writing them in by hand. 

In any case, they should unquestionably be integrated.  ^.^  If useful.  
And if useless, why are we keeping them there?

What particularly concerns me is code snippets being out of date...  If 
they can be versioned and kept, that would be the best thing, really.

Anisa.

Djun Kim wrote:

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

-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://drupal3.drupal.org/pipermail/documentation/attachments/20050614/e3f188f0/attachment.htm