MNT: Rename example files with 'test' in name

matthewfeickert · matthewfeickert · commit 873ca9106039 · 2022-06-08T01:42:34.000-05:00
In PR 23130 it was noticed that certain example files had 'test' in their name and were getting picked up automatically by pytest accidentally. To avoid this, `testpaths = lib` was added to pytest.ini. While this is sufficient to avoid future problems, removing the word 'test' from example files, and replacing it with 'demo' which is commonly used in other matplotlib examples, provides future safeguards. To further this idea, uses of the phrase 'test' in the example docstrings are replaced with 'demo'. To avoid causing broken links in the example documentation https://matplotlib.org/stable/gallery/index.html add `redirect-from` statements to the old file names as directed in https://matplotlib.org/stable/devel/documenting_mpl.html#moving-documentation.
diff --git a/examples/scales/semilogx_demo.py b/examples/scales/semilogx_demo.py
@@ -3,6 +3,8 @@
 Log Axis
 ========
 
+.. redirect-from:: /gallery/scales/log_test
+
 This is an example of assigning a log-scale for the x-axis using
 `~.axes.Axes.semilogx`.
 """
diff --git a/examples/text_labels_and_annotations/usetex_baseline.py b/examples/text_labels_and_annotations/usetex_baseline.py
@@ -1,8 +1,10 @@
 """
 ====================
-Usetex Baseline Test
+Usetex Baseline Demo
 ====================
 
+.. redirect-from:: /gallery/text_labels_and_annotations/usetex_baseline_test
+
 Comparison of text baselines computed for mathtext and usetex.
 """
 
diff --git a/examples/units/artist_demo.py b/examples/units/artist_demo.py
@@ -1,9 +1,11 @@
 """
-============
-Artist tests
-============
+===========
+Artist demo
+===========
 
-Test unit support with each of the Matplotlib primitive artist types.
+.. redirect-from:: /gallery/units/artist_tests
+
+Demonstrate unit support with each of the Matplotlib primitive artist types.
 
 The axis handles unit conversions and the artists keep a pointer to their axis
 parent. You must initialize the artists with the axis instance if you want to
diff --git a/examples/units/evans_demo.py b/examples/units/evans_demo.py
@@ -1,8 +1,10 @@
 """
 ==========
-Evans test
+Evans demo
 ==========
 
+.. redirect-from:: /gallery/units/evans_test
+
 A mockup "Foo" units class which supports conversion and different tick
 formatting depending on the "unit".  Here the "unit" is just a scalar
 conversion factor, but this example shows that Matplotlib is entirely agnostic
