Head.SmackOnTable();

The comment of all comments « Freekshow

What does the line of comment add? Does it tell you anything that the code does not? Indeed not. Zero points. This kind of gratuitous comments is all too common, and if you have many of these, will you keep reading them? Will you not start to blank out the comments in your mind, thereby possibly missing the important comment that actually does explain a certain coding decision?

Finanlly, what I consider to be a proper developer, agrees that commenting is bad. His example image proves my point:

The comment literally does not add anything – the code signature says everything you need to know – List<Joke> GetMostPopularJokes – Im guessing that its going to get you a list of the most popular jokes.

Testing ScribeFire for Firefox…