* made docstrings ready for first release.
* readme/walkthrough now needs major update before first release