Clean up jsdoc comments

Add class properties, expose some methods that should have
been documented, etc.
Merge pull request #645 from strongloop/docs/api-doc-fixes-2

Clean up jsdoc comments