matplotlib
diff --git a/‎doc/api/next_api_changes/development/24976-KS.rst
Copy file name to clipboard
+18Lines changed: 18 additions & 0 deletions b/‎doc/api/next_api_changes/development/24976-KS.rst
Copy file name to clipboard
+18Lines changed: 18 additions & 0 deletions
diff --git a/‎doc/devel/coding_guide.rst
Copy file name to clipboardExpand all lines: doc/devel/coding_guide.rst
+5Lines changed: 5 additions & 0 deletions b/‎doc/devel/coding_guide.rst
Copy file name to clipboardExpand all lines: doc/devel/coding_guide.rst
+5Lines changed: 5 additions & 0 deletions
@@ -0,0 +1,18 @@
+Provisional support for PEP484 Type Hint Annotations
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+New public API should be type hinted in ``.pyi`` stub files (except ``pyplot`` and tests
+which are typed in-line).
+Tests should be type hinted minimally, essentially only when ``mypy`` generates errors.
+
+CI and configuration for running ``mypy`` have been added.
+
+
+Generation of ``pyplot.py`` requires ``black``
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+The autogenerated portions of ``pyplot.py`` use ``black`` autoformatting to ensure
+syntax-correct, readable output code.
+
+As such ``black`` is now a development and test requirement (for the test which
+regenerates ``pyplot``).
@@ -82,6 +82,11 @@ rules before submitting a pull request:
   by the contributor's initials. (see :file:`doc/api/api_changes.rst` for more
   information)
 
+* If you add new public API or change public API, update or add the
+  corresponding type hints. Most often this is found in the corresponding
+  ``.pyi`` file for the ``.py`` file which was edited. Changes in ``pyplot.py``
+  are type hinted inline.
+
 * See below for additional points about :ref:`keyword-argument-processing`, if
   applicable for your pull request.