README updates, flake8 and pep257 auditing