By rick
via blogs.msdn.com
Published: Jun 10 2008 / 12:41
The "code is self document" argument often comes up when commenting conventions, patterns and overall usage is discussed. People who are typically against writing more than the existing set of comments will throw out the argument "if we need a comment then the code should be written to be self documenting."
Comments
antych replied ago:
Well written code can only tell you what's being done, but not why. Comments should be added to state intent and clear any ambiguities.
Voters For This Link (16)
Voters Against This Link (3)