If the comments are ugly, the code is ugly

If the comments are ugly, the code is ugly (via slashdot). Amen! I get uncomfortable whenever I have to leave a long comment, but it's usually to document some deficiency in a lower layer that the code is working around. Typically broken hardware. (So that someone coming behind me doesn't say, "This is overly complicated, I can simplify it" and then proceed to blow everything up.)

"Good programs do not contain spelling errors or have grammatical mistakes."

Posted on 2009-11-16 by brian in engineering .
Comments on this post are closed. If you have something to share, please send me email.