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 :-)

The original post was in the category: software_craftsmanship but I'm still in the process of migrating categories over.

The original post had 7 comments I'm in the process of migrating over.