Polish code commenting / documentation.

[tony]

Here are 3 annotated sources generated by http://jashkenas.github.com/docco/.

• backbone.js
• underscore.js
• backbone.marionette

Here is a blog post on it by Derick Baley, http://lostechies.com/derickbailey/2011/12/14/annotated-source-code-as-documentation-with-docco/.

[addyosmani]

We currently have something like this setup in backbone-aura/docs/aura.html (which uses docco), but we could definitely be doing a better job of it now that we're started reorganizing the project a little. Leaving this open to explore further.

[tony]

Ah, I see! In fact its my first time viewing that. Have we published backbone-aura's doccu online yet?

[addyosmani]

Not yet, but given how old the current doc is we should probably try hooking docco up to our build process or something so we can do that more easily through launches. https://github.com/DavidSouther/grunt-docco could be of help here.

[addyosmani]

@tony aside: would you like to become a full-member of the Aura team? If you're interested the project could definitely benefit from a keen eye on builds, code quality and how else we might improve in other areas.

[tony]

@addyosmani Yeah absolutely. We have a good thing going here.

[addyosmani]

@tony awesome. Added.

[dustinboston]

@tony Welcome aboard!

[addyosmani]

Closing due to age.