Archive

Archive for the ‘StyleCop’ Category

// Comments in code

February 2, 2011 1 comment

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 🙂

Advertisements