Right now I'm fixing some accessibility issues involving some code where people on my team (including myself) have been making changes to the code without a complete understanding of how things are supposed to work.

I don't want to keep pushing a bubble around under the rug so I've done some small refactorings (extract a chunk of <svg> into <SvgLogo>) and I'm now writing a huge comment that explains the status quo. I'm sure there are going to be some more refactorings in the same code and I expect to change the comment accordingly.

Frequently comments are apologies and are in themselves a bad smell.