James Tauber's Blog 2008/05/28


blog > 2008 > 05 >


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 : Created on May 28, 2008 : Last modified May 28, 2008 : (permalink)