[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