Provide a proper README file and update a couple of docstrings and comments