4 ms·
Fair, and I definitely get what you're saying, but I would still argue that for (Java)doc-style comments that one useful one outweighs the cost of the repetitio
by wool_gather 6y ago
Fair, and I definitely get what you're saying, but I would still argue that for (Java)doc-style comments that one useful one outweighs the cost of the repetition.
And the reason is that you're not always just reading the header. When I'm looking at a `setWiz` call site, my IDE can pop up just that one docstring and save me a bunch of aggravation.
- loup-vaillant 6y ago> I would still argue that for (Java)doc-style comments that one useful one outweighs the cost of the repetition. You have to actually notice it for it to matter. A missed comment is no better than an unwritten comment. > When I'm looking at a `setWiz` call site, my IDE can pop up just that one docstring and save me a bunch of aggravation. Didn't know about that. My IDE never did that (I used Visual Studio at some point, and now QtCreator).