simplify and cross-reference in docstrings for the various get methods
(#387)