News Feed
Sections




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

Shawn Stratton's Blog:
Code Readability, Part 1
January 13, 2009 @ 10:20:28

Shawn Stratton has posted the first part of his series looking at "Code Readability". This part focuses on something that is often woefully forgotten by many developers - proper code commenting.

The simplicity of PHP can sometimes be overwhelming, with so many different ways and approaches to creating solutions for our problems we sometimes lose the ability to think past the current problem and into the future. [...] Today I'm going to try to address some quick ideas that most of you will already be familiar with, things that will aide in the general readability of code for future generations.

He looks at the difference between useful and non-useful comments: DocBlocks, putting them near decisions, listing array parameters, recording TODOs and how it can all help you generate API documentation quickly and easily.

0 comments voice your opinion now!
readability docblock comment useful series


blog comments powered by Disqus

Similar Posts

Gary Hokin: An Introduction to Zend Framework 2 for the Zend Framework 1 Developer - Part 1

Zend Developer Zone: Generating and Validating Web Forms With PEAR HTML_QuickForm (part 2)

DZone.com: PHP Performance Crash Course, Part 2: The Deep Dive

Daniel Krook's Blog: Zend and IBM update PHP for i5/OS

PHPMaster.com: Localizing PHP Applications "The Right Way", Part 3


Community Events

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


extension list performance opinion introduction library podcast release api voicesoftheelephpant laravel framework series example version php7 community conference symfony2 interview

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