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
Fix typos and bad grammar in the documentation
Add a nice diagram on how site wide roles work