There is a common tendency, as we crank out code, to think that we’ll come back later and write some really good comments — comments that future reviewers will view with admiration for their clarity, completeness, and humor. But if we’re honest we have to admit: Later never comes. We never go back and write those great comments. Often, we don’t write any comments at all other than some placeholder we might dash off at the time.

Which is why Rule #4: Comment as You Go!

Continue reading →