// Comments in code

February 2, 2011 Leave a comment Go to comments

For all those devs who believe that writing comments in code will ensure someone (maybe even you) will fix it later:
You cannot manage a project that way, there are persons involved in decision-making around the features set who will not read your  code comment, so how can you believe those comments have any value in the process?

Good code comments make the not-so-obvious code obvious, and remember, the readers hardly ever have the same perspective on your code as you do, so it’s not what you find is important/obvious that counts. it’s what helps the read understand!

Ok.. got that off my chest.. now back to reading horrible code comments 🙂

Advertisement
  1. Morten Raasted
    September 15, 2011 at 05:05

    A wise collegue once told me: “The comments is the part of the code that even the compiler can’t understand!”

  1. No trackbacks yet.

Leave a Reply

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )

Connecting to %s

%d bloggers like this: