readme update, module-level docstrings/header updates primarily. updated sphinx-doc due to aforementioned