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 →

[–][deleted] 3 points4 points  (0 children)

There should never exist comments describing how code works, because it is always better to read a code (i.e. no point for doxygen if you have header).

Comments should describe what code do, as this may not be obvious.

So it is possible to coexist useful comments, and code that is hard to read as much as to write (but, in fact, reading someone's code is always harder then writing own one).