Comment Re:Comment your code (Score 2, Insightful) 590
This is the best, IMHO. I, too, have looked code and gone, "WTF was this idiot thinking????
And agreed - dead comments have to be updated. I didn't always do it perfectly, but I pretty much got in the habit a few years ago of commenting as I go, right by the code in question. One of those times when it's good to be a bit verbose.