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.
Slashdot Mirror
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.