|
Ahh I have been there. I now incessantly comment my code. I comment procedures, I comment variables, I comment the beginnings and ends of control structures, I comment changes logical shifts , I comment to explain algorithms.
Even worse than coming across uncommented code, is running across thoroughly commented code, and not having a clue what they mean. You read the comment, and say to yourself "OK...Now what the Hell does that mean?" or "OK I initialize that variable...why on earth would I do it there?".
It just never gets better. I now just tell myself that when I type a comment I need to make sure it can be understood by a moron, because more than likely I will be the next one to read the code.
Kerry <---Just a note from my daughter
|