Types of Comments to Avoid Making when Programming

Published 2010-07-24

Have you ever been reviewing code and come across a comment that you deemed was unnecessary? Commenting your code meant to improve the readability of your code and make it more understandable to someone other than the original developer.

I have identified 5 types of comments that really annoy me and the types of programmers who make them. I hope after reading this you won't be one who falls into one of these categories. As a challenge, you can try to match up these comment programmers with the 5 types of programmers.

<p>I do think one was missed - the guy who is learning and adds comments at each major piece of the puzzle. I am guilty as charged.</p></div>