News for hackers. Stuff that matters.
Re:Annotated code: Circles bouncing off lines by seanmcdirmid on Sunday February 08, 2015 @10:23PM (#9019593)
Inline comments are a part of the code's core layout, so you get into trouble when you make them disappear (as is the trouble with most folding systems).

It is like parenthetical statements in prose: you can't really make them disappear, they are right their in your face. It is considered bad style if they aren't extremely brief, otherwise you should use a foot or side note.

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.