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)