Update example configs for pre-commit hook in docs.

Author: stefmolin

doc/validation.rst

@@ -22,18 +22,20 @@ command line options for this hook:
 
     $ python -m numpydoc.hooks.validate_docstrings --help
 
-Using a config file provides additional customization. Both
-``pyproject.toml`` and ``setup.cfg`` are supported; however, if the
-project contains both you must use the ``pyproject.toml`` file.
-The example below configures the pre-commit hook to ignore three checks
+Using a config file provides additional customization. Both ``pyproject.toml``
+and ``setup.cfg`` are supported; however, if the project contains both
+you must use the ``pyproject.toml`` file. The example below configures
+the pre-commit hook to ignore three checks (using the same logic as the
+:ref:`validation during Sphinx build <_validation_during_sphinx_build>`)
 and specifies exceptions to the checks ``SS05`` (allow docstrings to
 start with "Process ", "Assess ", or "Access ") and ``GL08`` (allow
 the class/method/function with name "__init__" to not have a docstring).
 
 ``pyproject.toml``::
 
     [tool.numpydoc_validation]
-    ignore = [
+    checks = [
+        "all",   # run all checks, except the below
         "EX01",
         "SA01",
         "ES01",
@@ -44,7 +46,7 @@ the class/method/function with name "__init__" to not have a docstring).
 ``setup.cfg``::
 
     [tool:numpydoc_validation]
-    ignore = EX01,SA01,ES01
+    checks = all,EX01,SA01,ES01
     override_SS05 = ^((Process|Assess|Access) )
     override_GL08 = ^(__init__)$
 
@@ -96,6 +98,8 @@ For an exhaustive validation of the formatting of the docstring, use the
 incorrect capitalization, wrong order of the sections, and many other
 issues.
 
+.. _validation_during_sphinx_build
+
 Docstring Validation during Sphinx Build
 ----------------------------------------