Comment Re:Even more annoying... (Score 1) 1021
In my experience, it helps to write extensive comments for each function, rather than each line.
I write a comment block to explain what the function does and how its going to do it, before I write the code. Sometimes the very act of trying to explain what it is I'm going to do makes me re-evaluate the design of the function.