Improve shared class and method docs
Merge pull request #88 from strongloop/fix/minor-docs

Improve shared class and method docs