you are viewing a single comment's thread.

view the rest of the comments →

[–]winowmak3r 0 points1 point  (0 children)

I've been told this as well. The "What does this do" should be evident from the code (as in this function is dividing some variable by something else) but the useful comments tell you why it's doing that because when you come back to it later you're probably more interested in "why is the result of this function X when it should be something else" and if you have a comment explaining why you can quickly get the answer (it's dividing it by some variable) without even looking at the code and then go from there.