[WIP] Api docs

Opening a PR for this so we can discuss the docblocks. Fixes #2764.
Build result updated frequently at http://joostdevries.github.io/ember-cli/api-docs/build/