Added docs build status to README.md.
Updated codebase to be [PEP 8](http://legacy.python.org/dev/peps/pep-0008/) compliant.

According to automated tools, the only violations are now line length
and the occasional comment block.