PYTHON-3194 Adopt doc8 checker (#931)

.pre-commit-config.yaml

@@ -40,6 +40,7 @@ repos:
         'flake8-logging-format==0.6.0',
         'flake8-implicit-str-concat==0.2.0',
     ]
+    stages: [manual]
 
 # We use the Python version instead of the original version which seems to require Docker
 # https://github.com/koalaman/shellcheck-precommit
@@ -49,6 +50,14 @@ repos:
     - id: shellcheck
       name: shellcheck
       args: ["--severity=warning"]
+      stages: [manual]
+
+- repo: https://github.com/PyCQA/doc8
+  rev: 0.11.1
+  hooks:
+    - id: doc8
+      args: [--max-line-length=200]
+      stages: [manual]
 
 - repo: https://github.com/sirosen/check-jsonschema
   rev: 0.14.1
@@ -58,6 +67,7 @@ repos:
       files: ^\.github/workflows/
       types: [yaml]
       args: ["--schemafile", "https://json.schemastore.org/github-workflow"]
+      stages: [manual]
 
 - repo: https://github.com/ariebovenberg/slotscheck
   rev: v0.14.0

CONTRIBUTING.rst

@@ -55,6 +55,10 @@ To run ``pre-commit`` manually, run::
 
     pre-commit run --all-files
 
+To run a manual hook like `flake8` manually, run::
+
+    pre-commit run --all-files --hook-stage manual flake8
+
 Documentation
 -------------
 
@@ -67,7 +71,7 @@ You might also use the GitHub `Edit <https://github.com/blog/844-forking-with-th
 button.
 
 Re-sync Spec Tests
------------------
+------------------
 
 If you would like to re-sync the copy of the specification tests in the
 PyMongo repository with that which is inside the `specifications repo