[documentation] Real newbie documentation

Charlie Lowe cel4145 at cyberdash.com
Sat Jan 7 15:49:58 UTC 2006



Bèr Kessels wrote:
> I am an active comment-deleter. I delete comments on an almost daily basis. :) 
> But often I feel like an ++sh+le doing that, since I delete them for good. 
> However, support is support. and should not live as comments in the handbook. 
> Is that attitude good? Or should I be nicer and rather leave the comments?

Good question. Leaving the comments encourages more people to use the 
handbook as support. Optimally, we will want to modify the handbook page 
to address the comment in some way before deleting them. Perhaps, and 
this is just an idea that came to mind, when there is not the time at 
the moment to change the handbook page, a documentation issue could be 
created with the relevant text from the comments so that someone could 
later on update the page. That would allow the comments to be cleaned 
more regulary.


More information about the documentation mailing list