Improve shared class and method docs

/to @raymondfeng 
/cc @crandmck