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