Merge pull request #17094 from jklymak/doc-drop-experimental-constrained

QuLogic · web-flow · commit eb0917b779b8 · 2020-04-13T19:43:40.000-04:00
DOC: drop the experimental tag constrained_layout and tight_layout
diff --git a/doc/users/next_whats_new/2020-04-11-constrainedlayout-not-exp.rst b/doc/users/next_whats_new/2020-04-11-constrainedlayout-not-exp.rst
@@ -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`.
diff --git a/tutorials/intermediate/constrainedlayout_guide.py b/tutorials/intermediate/constrainedlayout_guide.py
@@ -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
 ==============
diff --git a/tutorials/intermediate/tight_layout_guide.py b/tutorials/intermediate/tight_layout_guide.py
@@ -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>`.
