3 ms·
I suspect many of the people who hate comments have mostly seen comments created by those who were forced to for some reason or another (I have heard of "commen
by userbinator 5y ago
I suspect many of the people who hate comments have mostly seen comments created by those who were forced to for some reason or another (I have heard of "commenting rate" being a "code quality" metric... which naturally leads to such situations of creating useless comments for the sake of appeasing stupid tools --- and even stupider managers), and thus aren't actually helpful.
Good comments should be more of a roadmap, and "why, not how". Also, an insanely long identifier (which then appears everywhere it's used) is far worse than a short one with a single explanatory comment at its definition.
- tablespoon 5y ago> Also, an insanely long identifier (which then appears everywhere it's used) is far worse than a short one with a single explanatory comment at its definition. Also, when you think about it: long identifiers are properly understood as a kind of comment.