DOC: Partial buff of schema.py docstring
DOC: Partial buff of schema.py docstring

No reason to complete, since going to convert to reST for
autodoc/Sphinx in the near term.

[skip ci]; no functional changes.

bskinn/sphobjinv