@aras lots of good points.

I've realised I keep coming back to the word 'intent' when writing code comments, commit messages, and PRs.

Most often, the why matters a lot more than the how and what.

People may have written their code perfectly, but if what they are trying to achieve is completely misguided comments are often useless.