Updated JSdoc 

Added class properties, clean up, expose some methods that should have been documented, etc.
@ritch 
Also we should use jsdoc's [@link](http://usejsdoc.org/tags-link.html) annotation for hyperlinks, but since that's not supported by strong-docs yet AFAIK,  we can't do that now.

I created two new issues to track these features:
 - https://github.com/strongloop-internal/strong-docs/issues/50
 - https://github.com/strongloop-internal/strong-docs/issues/51