proper use of yui-docs

a lot of comments are already written, yet not shown in the generated yui-docs.

Generate via ember ember-cli-yuidoc, generates to /docs/index.html within the project directory.

Probably requires @class, @public and other for each file.

See YUIDoc syntax

See services/session.js as an example