6 ms·
Consider the standard Java cough paradigm used by multitudes of developers, and on by default in many Java IDEs: /* Gets the person's name @returns
by dahvyd 14y ago
Consider the standard Java cough paradigm used by multitudes of developers, and on by default in many Java IDEs:
/* Gets the person's name
@returns the person's name */
public String getName() {
return name;
}
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.
- flatline3 14y agoIt 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.