Hacker Newsnew | past | comments | ask | show | jobs | submitlogin

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.



> 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).




Guidelines | FAQ | Lists | API | Security | Legal | Apply to YC | Contact

Search: