DOC: Mark subfigures as no longer provisional

Fixes matplotlib#25947

Author: QuLogic

doc/users/next_whats_new/subfigures_change_order.rst

@@ -1,3 +1,10 @@
+Subfigures no longer provisional
+--------------------------------
+
+The API on `.Figure.subfigures` and `.SubFigure` are now considered stable and
+will change under Matplotlib's normal deprecation process.
+
+
 Subfigures are now added in row-major order
 -------------------------------------------
 

galleries/examples/subplots_axes_and_figures/subfigures.py

@@ -13,9 +13,6 @@
 `matplotlib.figure.Figure.subfigures` to make an array of subfigures.  Note
 that subfigures can also have their own child subfigures.
 
-.. note::
-    The *subfigure* concept is new in v3.4, and the API is still provisional.
-
 """
 import matplotlib.pyplot as plt
 import numpy as np

lib/matplotlib/figure.py

@@ -6,9 +6,8 @@
     Many methods are implemented in `FigureBase`.
 
 `SubFigure`
-    A logical figure inside a figure, usually added to a figure (or parent
-    `SubFigure`) with `Figure.add_subfigure` or `Figure.subfigures` methods
-    (provisional API v3.4).
+    A logical figure inside a figure, usually added to a figure (or parent `SubFigure`)
+    with `Figure.add_subfigure` or `Figure.subfigures` methods.
 
 Figures are typically created using pyplot methods `~.pyplot.figure`,
 `~.pyplot.subplots`, and `~.pyplot.subplot_mosaic`.
@@ -1608,9 +1607,6 @@ 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::
-            The *subfigure* concept is new in v3.4, and the API is still provisional.
-
         .. versionchanged:: 3.10
             subfigures are now added in row-major order.
 
@@ -2229,9 +2225,6 @@ class SubFigure(FigureBase):
         axsR = sfigs[1].subplots(2, 1)
 
     See :doc:`/gallery/subplots_axes_and_figures/subfigures`
-
-    .. note::
-        The *subfigure* concept is new in v3.4, and the API is still provisional.
     """
 
     def __init__(self, parent, subplotspec, *,