4 ms·

How about toggle-able comments?

• seanmcdirmid 12y ago
  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.
  • sillysaurus3 12y ago
    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.
    • seanmcdirmid 12y ago
      Comments get in the way of the flow in reading code; they are often of little value that easily goes negative when they distract.
      • function_seven 12y ago
        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.
      • deleted 12y ago
        [deleted]