diff --git a/doc/release/upcoming_changes/20217.improvements.rst b/doc/release/upcoming_changes/20217.improvements.rst new file mode 100644 index 000000000000..28e5c8ff714d --- /dev/null +++ b/doc/release/upcoming_changes/20217.improvements.rst @@ -0,0 +1,10 @@ +Annotating the main Numpy namespace +-------------------------------------- +Starting from the 1.20 release, PEP 484 type annotations have been included +for parts of the NumPy library; annotating the remaining functions being a +work in progress. With the release of 1.22 this process has been completed for +the main NumPy namespace, which is now fully annotated. + +Besides the main namespace, a limited number of sub-packages contain +annotations as well. This includes, among others, `numpy.testing`, +`numpy.linalg` and `numpy.random` (available since 1.21).