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 new file mode 100644 index 000000000000..c8068213e14a --- /dev/null +++ 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 index 1975153db181..aa6398846843 100644 --- 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 index b1b047a3e7d3..befd70d48d6a 100644 --- 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 `.