The Daily Build

Icon

Software Development, version 3.0

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.”

Share and Enjoy:
  • del.icio.us
  • Digg
  • Sphinn
  • Facebook
  • Mixx
  • Google Bookmarks
  • Twitter
  • FriendFeed
  • Posterous
  • email

Related posts:

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

Category: engineering

Tagged:

Leave a Reply

Related Posts

Related posts:

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