Create docs about aura HOT 4 CLOSED

I think, given the usefulness of the inline comments we have, we can either extract them for part of the docs or offer people something like http://jashkenas.github.com/docco/ for a commented and easily viewable version of the source. We'll of course improve the narrative around the project too.

from aura.

@addyosmani I've been looking into docco for one of my projects, I like it. Lets use it. :-)

from aura.

@dustinboston So our docco docs currently cover the core components. Should it also cover the backbone extensions or do you feel that's unnecessary? Between the readme and what we have there do you think theres a need for further docs (we will of course add more as we go on), or can this issue be closed?

from aura.

@addyosmani I don't think we need more documentation on the extensions unless we find that folks are having a hard time putting them together. Case closed.

from aura.