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.
Since `dev.txt` has hashes in it, you should probably use peep here, instead of pip.