News Feed
Sections




News Archive
Looking for more information on how to do PHP the right way? Check out PHP: The Right Way

Anthony Ferrara's Blog:
To Comment Or Not To Comment - A Tale Of Two Stories
June 08, 2012 @ 11:02:20

In this recent post to his blog Anthony Ferrara looks at commenting in your application's code and how to be effective (and not so effective) when using them.

A few weeks ago I was sparked into a twitter conversation with Larry Garfield (@Crell) about the value of comments in code. [...] A pretty innocuous comment [about code that doesn't have comments] that is quite insightful. [...] That led to an interesting discussion that just couldn't fit on twitter. So let me explain...

He defines what he means by "comments" (DocBlock, general comments and legal information) and what sort of things should be inside of them. He also points out a few things not to do in you comments including being overly descriptive and restating what the code is doing (they should be less about that and more about the "Why"). Of course, there's exceptions and he touches on those briefly to finish out the post.

0 comments voice your opinion now!
comment code opinion useful


blog comments powered by Disqus

Similar Posts

Francois Zaninotto: Node.js for PHP Developers Series

Alexei Shuga's Blog: On passing Zend PHP 5.3 exam

Paul Jones' Blog: When Possible, Use File *Resources* Instead Of File *Names*

Alvaro Videla's Blog: Reply to "Scala is Easier than PHP"

php|architect: PHP is not a Swiss Army Knife, quit calling it that.


Community Events





Don't see your event here?
Let us know!


series configure api release unittest introduction version voicesoftheelephpant interview symfony language list composer conference opinion podcast install community extension laravel

All content copyright, 2015 PHPDeveloper.org :: info@phpdeveloper.org - Powered by the Solar PHP Framework