3 ms·
Redundant comments are as annoying as repeating yourself in writing. Redundant comments are as annoying as repeating yourself in writing (and I'm certainly as
by jashkenas 16y ago
Redundant comments are as annoying as repeating yourself in writing.
Redundant comments are as annoying as repeating yourself in writing (and I'm certainly as guilty of it as anyone). But the real point of the comments is to explain the "why", just as the code explains the "how". In your example above, to explain the reason that you've chosen to mix in the modules you're mixing in...
- bguthrie 16y agoI was trying to be subtle about it, but the example I used was drawn from a fairly well-known (albeit, I should add, well-written) JS library. My point is that this style of documentation encourages that behavior, perhaps paradoxically because it's so attractive and big hunks of whitespace tend to stand out.