Agreed with OP; my succinct version is: use comments for why not what. E.g. comments about "what" will be repetitive, out-of-date, etc. But comments about "wh

Agreed with OP; my succinct version is: use comments for why not what. E.g. comments about "what" will be repetitive, out-of-date, etc. But comments about "why" we're doing something a particular way, especially if it's odd, are great sign posts to future maintainers.