Thanks for the reply. I didn't mean to be dismissive or discredit the article.

The problem you described is real, and one I face daily at work. Anecdotally, every time we've tried to curate the comments and organize them (especially when referencing external documentation, as you also mentioned), it invariably ends up becoming stale and just another point of contention down the road.

I'm now more of a proponent of either not commenting, or putting the context and rationale in the commit message instead.