James Tauber's Blog 2008/05/28
Question-Driven Commenting
I've always loved Titus Brown's notion of stupidity driven testing. It's okay to make a mistake but you write a test to make sure you don't do it again.
With Pinax, I've been adopting the sister practice of "question-driven commenting". When someone asks me what a function does or how to implement a particular extension, that's when I go and add comments to the code.
Of course, the person asking the question could be me :-)
by James Tauber : Created on May 28, 2008 : Last modified May 28, 2008 : Categories software_craftsmanship : 7 comments (permalink)