
<HTML><BODY style="word-wrap: break-word; -khtml-nbsp-mode: space; -khtml-line-break: after-white-space; "><BR><DIV><DIV>On Jan 7, 2006, at 5:15 AM, Bèr Kessels wrote:</DIV><BR class="Apple-interchange-newline"><BLOCKQUOTE type="cite"><P style="margin: 0.0px 0.0px 0.0px 0.0px"><FONT face="Helvetica" size="3" style="font: 12.0px Helvetica">I am an active comment-deleter. I delete comments on an almost daily basis. :)<SPAN class="Apple-converted-space"> </SPAN></FONT></P> <P style="margin: 0.0px 0.0px 0.0px 0.0px"><FONT face="Helvetica" size="3" style="font: 12.0px Helvetica">But often I feel like an ++sh+le doing that, since I delete them for good.<SPAN class="Apple-converted-space"> </SPAN></FONT></P> <P style="margin: 0.0px 0.0px 0.0px 0.0px"><FONT face="Helvetica" size="3" style="font: 12.0px Helvetica">However, support is support. and should not live as comments in the handbook.<SPAN class="Apple-converted-space"> </SPAN></FONT></P> <P style="margin: 0.0px 0.0px 0.0px 0.0px"><FONT face="Helvetica" size="3" style="font: 12.0px Helvetica">Is that attitude good? Or should I be nicer and rather leave the comments?</FONT></P> </BLOCKQUOTE><BR></DIV><DIV>Yes, we need to delete comments.  I worked on the 2nd and 3rd most commented pages and cleaned them out last night.  Each page had around 30 comments, in some cases going back to 2002.  I worked in #drupal to get others to confirm code samples worked and installed them myself to ensure the documentation was still up to date.  I argued if I can't use the the documentation to create running code then the documentation is at fault.  I moved a lot of improvements and code samples into the main pages out of the comments and linked forum posts.  I also tagged the pages as 4.6 or 4.5 and older in one case.</DIV><DIV><BR class="khtml-block-placeholder"></DIV><DIV>Comments make the handbook look sloppy.   At the same time there is a lot of wisdom and value in those comments.  It's a difficult task to extract what's useful and to run the code or configure a site to confirm the documentation.</DIV><DIV><BR class="khtml-block-placeholder"></DIV><DIV>However, it's also a privilege to use the wisdom of this community and raise the collective intelligence[1] of Drupal by improving the documentation.</DIV><DIV><BR class="khtml-block-placeholder"></DIV><DIV>Kieran</DIV><DIV><BR class="khtml-block-placeholder"></DIV><DIV>[1] <A href="http://www.accelerating.org/ac2004/slides/AC2004(Engelbart).ppt">http://www.accelerating.org/ac2004/slides/AC2004(Engelbart).ppt</A></DIV><DIV><BR class="khtml-block-placeholder"></DIV><DIV><BR class="khtml-block-placeholder"></DIV><BR></BODY></HTML>