Monthly Archives: June 2013

New Research Shows Dramatic Impact of Style and Form on Code Maintainability

Academic researchers are catching up to what coder intuition inferred long ago:

  • that the formatting of our code has a huge demonstrable effect on the productivity of the people who have to maintain it after us.
  • that using surprising or ‘clever’ notation (where a clearer syntax would suit) has an even bigger effect. And don’t persuade yourself that your code is ‘optimized’ rather than merely opaque. PREMATURE OPTIMIZATION IS THE ROOT OF ALL EVIL.

The full study is here, but academics continue to practice (job-) security-by-obscurity, so I don’t recommend actually reading the thing. 

More Sublime Hotkeys: Custom Package for Use with Angular

The Angular-UI project have produced an excellent package that provides auto-completion and lookup for Angular directives/controllers/services/filters/etc., in both Sublime 2 and 3. Go get it, install, then check out these crucial hotkeys:

  • Index My Angular Project⌘-CTRL-L
    Once you’ve done this, Angular should recognize all of your Angular components. If your project is already indexed, this hotkey will open a quick-panel containing all of your components and you can jump to a component from there. 
  • GoTo Definition of This Component⌘-CTRL-OPT-L
    Whatever Angular component is referenced at your insertion point, Sublime will attempt to jump directly to its definition within the project, opening the file if necessary. Remember that you’ll need to index the project first for this to work.
  • Get Online Documentation for This Built-In Component⌘-CTRL-SHIFT-L
    If your insertion point is inside a reference to, perhaps, ng-click, the package will open your default browser to the official documentation for ng-click, or to any other Angular component  that ships with the official distribution.