DOC: Add pre-commit hook run dev instructions

matthewfeickert · matthewfeickert · commit 48ade7d9043f · 2022-04-13T18:13:41.000-05:00
Add instructions to the devs on how to manually run pre-commit hooks, both for
all the hooks, and for individual hook ids. Example:
`pre-commit run flake8 --all-files`

Also use the 'python -m pip' pattern to be consistent with the rest of the docs.
diff --git a/doc/devel/development_setup.rst b/doc/devel/development_setup.rst
@@ -67,9 +67,18 @@ These will automatically check flake8 and other style issues when you run
 ``git commit``. The hooks are defined in the top level
 ``.pre-commit-config.yaml`` file. To install the hooks ::
 
-    pip install pre-commit
+    python -m pip install pre-commit
     pre-commit install
 
+The hooks can also be run manually. All the hooks can be run, in order as
+listed in ``.pre-commit-config.yaml``, against the full codebase with ::
+
+    pre-commit run --all-files
+
+To run a particular hook manually, run ``pre-commit run`` with the hook id ::
+
+    pre-commit run <hook id> --all-files
+
 Installing additional dependencies for development
 ==================================================
 See :ref:`development-dependencies`.
