DEV Community

Serguey Asael Shinder
Serguey Asael Shinder

Posted on

Comments Lie. Code Doesn't.

A comment can say one thing.
The code below it does another.

Comments drift. Code runs.
One is a wish. One is the truth.

The best comment is a better name.
A clearer function. A smaller block.

Don't explain the mess.
Remove the need to explain.

Make the code the documentation.
Then it can't lie.

– Serguey Asael Shinder

Top comments (0)