Stop Writing Comments. Start Deleting Them.

Code gets edited under deadline. Comments do not. Within months the prose and the logic disagree, and the reader cannot tell which one is right.

A constraint the code cannot express: why the obvious approach fails, which invariant a caller depends on, what breaks if you reorder these lines.

Everything else belongs in the code itself, or nowhere.