4 ms·
> I often notice that I can remove a comment line after renaming a few identifiers in the code below it, because the code starts to read self-explanatory enough
by noobiemcfoob 10y ago
> I often notice that I can remove a comment line after renaming a few identifiers in the code below it, because the code starts to read self-explanatory enough.
Careful with that. I'm of the mind that the code author is incapable of describing how readable any codebase is. It's too easy to mistake your innate understanding of your own creation for readability.
- chrisweekly 10y agoAlso, while good names might obviate the need for "what" comments, they can't replace often-invaluable "why" comments.
- nine_k 10y agoGood comments are usually about "why" and "what", while the code is about the "how". Code with descriptive identifiers often make code read like plain English.