News for hackers. Stuff that matters.
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:

    /* 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.
Re:Thoughts on being a programmer by flatline3 on Thursday August 16, 2012 @12:48PM (#4392236)
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.