matplotlib
diff --git a/‎doc/api/next_api_changes/2019-08-12-KS.rst
-8 b/‎doc/api/next_api_changes/2019-08-12-KS.rst
-8
diff --git a/‎doc/api/next_api_changes/behaviour.rst
+10 b/‎doc/api/next_api_changes/behaviour.rst
+10
@@ -122,3 +122,13 @@ This behavior is consistent with other figure saving methods
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 This is consistent with other signature mismatch errors.  Previously a
 ValueError was raised.
+
+
+`.Axes.annotate` and `.pyplot.annotate` parameter name changed
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+The parameter ``s`` to `.Axes.annotate` and  `.pyplot.annotate` is renamed to
+``text``, matching `.Annotation`.
+
+The old parameter name remains supported for `.Axes.annotate`, but
+support for it will be dropped in a future Matplotlib release.
+