flake8 settings

Author: stefdoerr

flake8-docstrings.cfg

@@ -0,0 +1,15 @@
+[flake8]
+# Docstring/signature consistency check (pydoclint as a flake8 plugin).
+# Used only by the dedicated CI step via `flake8 --config=flake8-docstrings.cfg`,
+# so it does not affect the other flake8 invocations.
+#
+# Scope is intentionally narrow: enforce only that documented parameters match
+# the function signature (names/presence). Type-string and coverage checks are
+# left out on purpose (the codebase is partially typed by design, and rendered
+# docs take types from the signatures).
+select = DOC101,DOC102,DOC103
+style = numpy
+skip_checking_private_functions = True
+ignore_underscore_args = True
+ignore_private_args = True
+should_document_star_arguments = False