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.
Ok. @willkg trumps me here. I would leave the version numbers. I don't care about the hashes, they could stay or go.