If It Needs a Manual, Rewrite It

I used to be proud of my comments.
Long ones. Careful ones.

Then I realized:
a comment is an apology
for code that didn’t explain itself.

Now I rename instead of annotate.
Split instead of describe.

If the next person needs a manual,
I didn’t finish.
I just stopped.

– Serguey Asael Shinder

Leave a comment