Merge pull request matplotlib#20004 from meeseeksmachine/auto-backport-of-pr-19999-on-v3.4.x

Backport PR matplotlib#19999 on branch v3.4.x (DOC: add note about axes order to docstring)

Author: QuLogic

lib/matplotlib/figure.py

@@ -1740,7 +1740,9 @@ def subplot_mosaic(self, layout, *, subplot_kw=None, gridspec_kw=None,
         Returns
         -------
         dict[label, Axes]
-           A dictionary mapping the labels to the Axes objects.
+           A dictionary mapping the labels to the Axes objects.  The order of
+           the axes is left-to-right and top-to-bottom of their position in the
+           total layout.
 
         """
         subplot_kw = subplot_kw or {}

lib/matplotlib/pyplot.py

@@ -1511,7 +1511,9 @@ def subplot_mosaic(layout, *, subplot_kw=None, gridspec_kw=None,
        The new figure
 
     dict[label, Axes]
-       A dictionary mapping the labels to the Axes objects.
+       A dictionary mapping the labels to the Axes objects.  The order of
+       the axes is left-to-right and top-to-bottom of their position in the
+       total layout.
 
     """
     fig = figure(**fig_kw)