Where Comments Are Useful

PHP In Action writes on the use of comments in code, specifically citing Eli White’s Commenting on Commenting over at PHP Advent. They are critical of Eli’s advice, saying that comments should be unnecessary, and that code should be clean enough to easily understand it.

There’s a lot of good advice, especially about writing clean code. But the article fails to address a good number of really critical details and to some degree misses the point of Eli’s article.

(more…)

Wednesday, December 24th, 2008 @ 11:30 pm | Comment (1) | Categories: Usability, Web Architecture, Best Practices
Tags: ,


Copyright © 2023 by Brandon Savage. All rights reserved.