I remember seeing a fortune or the like that said :

Documentation is like sex. When it’s good its very very good. When it’s  bad, it’s better than nothing. 

I found many times this rule applies to comments I’ve encountered in difficult code I’ve had the chore in debugging. :-) 

Earl 

Sent from my iPhone