I think the problem of stuff going out of date can be avoided by giving background (why it was originally written) rather than making a commitment you can't keep about keeping it up to date.
Knowing why code was originally written can be more important than knowing what it currently does.
Great advice, and it does resonate. FWIW I'm certainly not a "no comments" guy. I just like to check myself to see if there is a better way to accomplish what I was going to do with a comment.
Knowing why code was originally written can be more important than knowing what it currently does.