[jbjohns]

Couldn't disagree more. Comments should only ever be present to explain why a choice was made. Never what code is doing. If it needs to explain what the code does, the code needs to be rewritten.

Comments don't compile, so the only documentation of what code is doing guaranteed to be correct is the code itself.

[P_I_Staker]

Comments go beyond explaining why a choice was made, and this is usually not very useful information for a comment.

Really like comments for providing edge cases and information that can't be found by reading and understanding the code.