docs(validation.rst,-install.rst): Added docs for new feature numpydoc_validation_exclude_files for Sphinx and exclude_files for pyproject.toml

Author: mattgebert

doc/install.rst

@@ -139,6 +139,18 @@ numpydoc_validation_exclude : set
     validation.
     Only has an effect when docstring validation is activated, i.e.
     ``numpydoc_validation_checks`` is not an empty set.
+  numpydoc_validation_exclude_files : set
+    A container of strings using :py:mod:`re` syntax specifying path patterns to
+    ignore for docstring validation.
+    For example, to skip docstring validation for all objects in
+    ``tests\``::
+
+        numpydoc_validation_exclude_files = {"$.*tests/.*"}
+
+    The default is an empty set meaning no paths are excluded from docstring
+    validation.
+    Only has an effect when docstring validation is activated, i.e.
+    ``numpydoc_validation_checks`` is not an empty set.
 numpydoc_validation_overrides : dict
     A dictionary mapping :ref:`validation checks <validation_checks>` to a
     container of strings using :py:mod:`re` syntax specifying patterns to

doc/validation.rst

@@ -37,7 +37,9 @@ the pre-commit hook as follows:
   maps to ``numpydoc_validation_exclude`` from the
   :ref:`Sphinx build configuration <validation_during_sphinx_build>`.
 * ``exclude_files``: Exclude file paths matching the regular expressions
-    ``^tests/.*`` or ``^module/gui.*``.
+    ``^tests/.*`` or ``^module/gui.*``. This maps to
+    ``numpydoc_validation_exclude_files`` from the
+    :ref:`Sphinx build configuration <validation_during_sphinx_build>`.
 * ``override_SS05``: Allow docstrings to start with "Process ", "Assess ",
   or "Access ". To override different checks, add a field for each code in
   the form of ``override_<code>`` with a collection of regular expression(s)