I used to think commenting my code was the responsible thing to do. I used to think that I should have a comment for just about every line of code that I wrote. After my first read of Code Complete, my views changed pretty drastically.
Wednesday, May 12, 2010
Eliminating Comments: the Road to Clarity
link -> Eliminating Comments: the Road to Clarity
The proper use of comments is to compensate for our failure to express yourself in code. Note that I used the word failure. I meant it. Comments are always failures.