Fixes for bug 1112084 and some doc changes

All the dev requirements have been specified in requirements/dev.txt and are installed while the VM is provisioned. Docs have been updated for the current pre-commit hook. The users no longer have to install flake8 manually.