Improve docstrings and documentation

resolves #28