DOC: expand on docstrings
DOC: docstring cleanup
DOC: clarify and cleanup