Provide a proper README file and update a couple of docstrings and comments
Merge pull request #12 from pbs/LUN-832

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