I've done a lot of digging through other people's code, in general the only comments I've found helpful are those that explicitly call out defective code, and t

I've done a lot of digging through other people's code, in general the only comments I've found helpful are those that explicitly call out defective code, and those that provide links to external references. Writing clear code is the only hope for the poor maintenance programmer, your carefully written comments probably aren't worth the effort.