Hacker Newsnew | past | comments | ask | show | jobs | submitlogin

Comments get in the way of the flow in reading code; they are often of little value that easily goes negative when they distract.


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.




Guidelines | FAQ | Lists | API | Security | Legal | Apply to YC | Contact

Search: