Comments

Delete the comment. Fix the code.

Article: Comments

A comment that explains what code does is a confession: the code had something to say and could not say it. Now there are two representations of the same thing, and they will drift. // Get active users still said so six months after the function started returning banned ones.

Three rules for the comments a linter can recognise: code that was commented out instead of deleted, a TODO that says nothing, and a function narrated by section headers.