Revert "Revert "README.rst: Syntax highlight Python examples""

This reverts commit 247fda3d9594058f60807796a7866d8c20ba3da8.
Fix the check env to use collective.checkdocs for checking the readme/long_description.