Provide a proper README file and update a couple of docstrings and comme...

...nts