Re:Thoughts on being a programmer
by dahvyd on Wednesday August 15, 2012 @05:27AM
(#4385234)
Consider the standard Java cough paradigm used by multitudes of developers, and on by default in many Java IDEs:
That is insane. The comment adds nothing to anyone's day and helps no one better understand the method than after simply reading the method signature.
[ Parent
| on HN ]
It generates auto-docs, which are useful. It's just a ridiculously verbose way to do it, and it would be preferable if the documentation could be generated without the repetitive comment.