cleanup of docs, and pep8/flake8