My thoughts and favorite points of someone else’s writing from the web:
This article is delightfully short and to the point, I would encourage you to go read it. But the gist is that // TODO: comments in code are great ways to document issues that you know about but aren’t important enough to prioritize fixing at the moment.
- an edge case that wasn’t handled
- a suggestion for a better structure
- some other refactoring that the code could benefit from
They’re a way of documenting to the next programmer who comes through here that if this code is modified, it might be nice to fix this too.