<?xml version="1.0"?>
<rss version="2.0">
  <channel>
    <title>PHPDeveloper.org</title>
    <link>http://www.phpdeveloper.org</link>
    <description>Up-to-the Minute PHP News, views and community</description>
    <language>en-us</language>
    <pubDate>Thu, 24 May 2012 16:06:13 -0500</pubDate>
    <ttl>30</ttl>
    <item>
      <title><![CDATA[Community News: Comments on Commenting]]></title>
      <guid>http://www.phpdeveloper.org/news/12442</guid>
      <link>http://www.phpdeveloper.org/news/12442</link>
      <description><![CDATA[<p>
Thanks to an <a href="http://www.brandonsavage.net/on-code-commenting-and-technical-debt/">initial article</a> from <i>Brandon Savage</i> the topic of code commenting has been floating around the PHP community and several members have taken the opportunity to express a few thoughts of their own:
</p>
<ul>
<li><i>Brandon Savage</i>'s <a href="http://www.brandonsavage.net/on-code-commenting-and-technical-debt/">blog entry</a> kicking off the discussion by noting that not commenting the code is the "accrual of <a href="http://www.brandonsavage.net/paying-down-technical-debt/">technical debt</a>".
<li>In <a href="http://mtabini.blogspot.com/2009/04/myth-of-myth-of-self-commenting-code.html">his blog post</a> <i>Marco Tabini</i> mostly agrees with <i>Brandon</i>'s comments with one difference - he suggests that correct code doesn't need comments.
<li><i>Dagfinn Reiersol</i> takes a more pragmatic approach to the issue and wants to <a href="http://blog.agilephp.com/2009/04/30/show-me-your-code-comments-and-ill-show-why-you-dont-need-them/">see the code</a> before making a decision on whether the comments are needed or not.
<li><i>Benjamin Eberlei</i> <a href="http://www.whitewashing.de/blog/articles/116">reinforces this refactoring idea</a> and suggests staying away from ambiguous names and unclear code practices.
<li><i>Richard Thomas</i> notes that <a href="http://www.phpjack.com/content/comments-are-not-cure-or-disease">comments have their place</a> but they don't need to be taken to either extreme.
<li><i>Rob Allen</i>'s <a href="http://blog.agilephp.com/2009/05/02/most-confused-discussion-in-the-known-universe/">opinions</a> on <a href="http://www.whitewashing.de/blog/articles/116">Benjamin Eberlei's thoughts</a>
<li><i>Brandon Savage</i>'s <a href="http://www.brandonsavage.net/in-defense-of-commenting/">reply to all of the criticism</a> he's recieved over his initial post
</ul>
<p>
Posted any thoughts or comments of your own on the subject and do see them here? <a href="mailto:info@phpdeveloper.org?subject=Comments Discussion">Let us know!</a>
</p>]]></description>
      <pubDate>Fri, 01 May 2009 11:18:04 -0500</pubDate>
    </item>
  </channel>
</rss>

