* various docstring fixes
* various changes and improvements to README.md