Add note that subfigure is still provisional to docstring

timhoffm · timhoffm · commit 0e96cbcbc502 · 2023-05-23T06:54:05.000+02:00
This matches the notes at https://matplotlib.org/stable/gallery/subplots_axes_and_figures/subfigures.html#figure-subfigures
diff --git a/lib/matplotlib/figure.py b/lib/matplotlib/figure.py
@@ -1552,6 +1552,9 @@ def subfigures(self, nrows=1, ncols=1, squeeze=True,
         the same as a figure, but cannot print itself.
         See :doc:`/gallery/subplots_axes_and_figures/subfigures`.
 
+        .. note::
+            ``subfigure`` is new in v3.4, and the API is still provisional.
+
         Parameters
         ----------
         nrows, ncols : int, default: 1
