Improve documentation
At present we have a README and a little bit of help text in the main file. It'd be good to add to this to:
- Cover application usage in the README
- Provide more information in the help text
- Validate sample usages work using doctest
- Generate documentation using pydoc and publish it to readthedocs