News Feed
Sections




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

PHP in Action:
Comments Considered Harmful
December 24, 2008 @ 13:41:38

In this new post from the PHP in Action blog, they comment on Eli White's comments on commenting.

There is too much old advice in PHP. A recent case comes from the PHP Advent calendar. Eli White is a strong believer in commenting code, including inline comments inside functions. Unfortunately, he's at least 10 years too late. This used to be good advice, but not any more. Up to a point, he's right.

They propose a better way - refactoring code so that its as easy to read as possible, reducing the need for extensive commenting. They illustrate with a rework from the Zend Framework function, changing up the method names to better reflect the action inside (rather than the current "doUpdate").

4 comments voice your opinion now!
comment harmful refactor understand zendframework


blog comments powered by Disqus

Similar Posts

Padraic Brady's Blog: An Example Zend Framework Blog App - Part 2: The MVC Application Architecture

Matthew Weier O'Phinney's Blog: Using Action Helpers To Implement Re-Usable Widgets

Ibuildings techPortal: DPC Radio: Let's take over the world with Zend Framework

ProDevTips.com: Writing a CMS/Community with Smarty and the Zend Framework: Part 6

Padraic Brady's Blog: Zend Framework: Surviving The Deep End Report!


Community Events

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


example library install voicesoftheelephpant laravel5 api podcast php7 community interview unittest opinion xdebug extension release introduction framework language series laravel

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