Nov 16, 2009
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.”
Related posts:
- Data vs Code I’ll take an array over a giant switch-case statement...
- Insist on Automatic Tests At some point your team is going to be...
- One Simple Step for Avoiding Shallow Reviews It's your job as a reviewer to find as many...
- 9 “Must-Have” Tools for Software Teams The items below are useful systems based on my...
- How to Use SSH Remote Port Forwarding to Set Up Secure Tunnels Ssh tunneling can be a bit mind bending at first,...