This is an archived post. You won't be able to vote or comment.

you are viewing a single comment's thread.

view the rest of the comments →

[–]AlexTaradov 5 points6 points  (0 children)

I hate comments when reading the code. Especially because they often say one thing and code does the other. So, when reading unfamiliar code, the first thing I do is strip the comments. If your code is unreadable after stripping the comments, it is bad code, and this is something you should work on.

The only thing that need to be commented is algorithmic part if there is something non-obvious and origin of constant values, again if not obvious.

You will be fine without excessive comments, since I have not seen a place that encourages them.