<html><head></head><body style="word-wrap: break-word; -webkit-nbsp-mode: space; -webkit-line-break: after-white-space; "><div>Possibly, but that's a matter of opinion. Personally, I find that undocumented code is harder to maintain in the long run. I definitely do not agree with that article though as the "docblock" style example is a bit over-the-top while the function most-likely does not need to be documented. Everything in-between is not covered. For me, documentation serves as a record of intention. If the words do not match the code, it is easier for me or someone else to debug. I love it! You can't make me stop :)</div><br><div><div>On Jul 5, 2011, at 6:32 AM, scribu wrote:</div><br class="Apple-interchange-newline"><blockquote type="cite">Michael, if 50% of the file is made up of comments, then you might be doing something wrong. See:<br><br><a href="http://www.codinghorror.com/blog/2008/07/coding-without-comments.html">http://www.codinghorror.com/blog/2008/07/coding-without-comments.html</a><br>
<br>-- <br><a href="http://scribu.net/" target="_blank">http://scribu.net</a><br>
_______________________________________________<br>theme-reviewers mailing list<br><a href="mailto:theme-reviewers@lists.wordpress.org">theme-reviewers@lists.wordpress.org</a><br>http://lists.wordpress.org/mailman/listinfo/theme-reviewers<br></blockquote></div><br></body></html>