matplotlib
diff --git a/‎doc/users/next_whats_new/2020-04-11-constrainedlayout-not-exp.rst
Copy file name to clipboard
+7Lines changed: 7 additions & 0 deletions b/‎doc/users/next_whats_new/2020-04-11-constrainedlayout-not-exp.rst
Copy file name to clipboard
+7Lines changed: 7 additions & 0 deletions
diff --git a/‎tutorials/intermediate/constrainedlayout_guide.py
Copy file name to clipboardExpand all lines: tutorials/intermediate/constrainedlayout_guide.py
+5-6Lines changed: 5 additions & 6 deletions b/‎tutorials/intermediate/constrainedlayout_guide.py
Copy file name to clipboardExpand all lines: tutorials/intermediate/constrainedlayout_guide.py
+5-6Lines changed: 5 additions & 6 deletions
diff --git a/‎tutorials/intermediate/tight_layout_guide.py
Copy file name to clipboardExpand all lines: tutorials/intermediate/tight_layout_guide.py
+3-3Lines changed: 3 additions & 3 deletions b/‎tutorials/intermediate/tight_layout_guide.py
Copy file name to clipboardExpand all lines: tutorials/intermediate/tight_layout_guide.py
+3-3Lines changed: 3 additions & 3 deletions
@@ -0,0 +1,7 @@
+Constrained layout is no longer marked as experimental
+------------------------------------------------------
+
+The *constrained_layout* option for figures and gridspecs was introduced
+in Matplotlib 2.2, and is no longer considered experimental.  For an
+overview of the feature, please see
+:doc:`/tutorials/intermediate/constrainedlayout_guide`.
@@ -30,12 +30,11 @@
 
 .. warning::
 
-    Currently Constrained Layout is **experimental**.  The
-    behaviour and API are subject to change, or the whole functionality
-    may be removed without a deprecation period.  If you *require* your
-    plots to be absolutely reproducible, get the Axes positions after
-    running Constrained Layout and use ``ax.set_position()`` in your code
-    with ``constrained_layout=False``.
+    Constrained layout can lead to irreproducible plots
+    as the solver sometimes returns slightly different results.
+    If you *require* your plots to be absolutely reproducible, get the
+    Axes positions after running Constrained Layout and use
+    ``ax.set_position()`` in your code with ``constrained_layout=False``.
 
 Simple Example
 ==============
 
@@ -6,9 +6,9 @@
 How to use tight-layout to fit plots within your figure cleanly.
 
 *tight_layout* automatically adjusts subplot params so that the
-subplot(s) fits in to the figure area. This is an experimental
-feature and may not work for some cases. It only checks the extents
-of ticklabels, axis labels, and titles.
+subplot(s) fits in to the figure area. This feature may not work
+for some cases. It only checks the extents of ticklabels, axis labels,
+and titles.
 
 An alternative to *tight_layout* is :doc:`constrained_layout
 </tutorials/intermediate/constrainedlayout_guide>`.