Another Reason to Avoid Comments

16. April, 2022

There is this old saying that if you feel you have to write a comment to explain what your code does, you should rather improve your code.

In the talk above, I heard another one:

A common fallacy is to assume authors of incomprehensible code will somehow be able to express themselves lucidly and clearly in comments.
– Kevlin Henney

Leave a Comment » | Comment, Software | Tagged: , | Permalink
Posted by digulla

Code Comments Stink

27. July, 2009

If you ever need a good argument why code should be readable without comments, look here.

Dead languages are dead because they don’t fit today anymore. Let them rest.

Leave a Comment » | Philosophy, Software | Tagged: , | Permalink
Posted by digulla

%d bloggers like this: