News for hackers. Stuff that matters.
Re:Annotated code: Circles bouncing off lines by sillysaurus3 on Sunday February 08, 2015 @11:02PM (#9019677)
Why are people trying to make comments disappear? They are there for a reason. I agree with what moe is saying, though not moe's tone.
Re:Annotated code: Circles bouncing off lines by seanmcdirmid on Sunday February 08, 2015 @11:15PM (#9019705)
Comments get in the way of the flow in reading code; they are often of little value that easily goes negative when they distract.
Re:Annotated code: Circles bouncing off lines by function_seven on Monday February 09, 2015 @01:34AM (#9019956)
My biggest pet peeve is docblocked-to-death code, like

    class Widget
    {
        /**
         * @access public
         * The name of the widget
         */
        public $name;

        /**
         * @access private
         * The widget's material composition
         */
        private $composition;

        // ... yada, yada ...
    }
Even with syntax highlighting on, it can be a pain in the ass to see the code through all that comment noise. I guess I should take the time to configure my folding more.