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.
[ Parent
| on HN ]
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.