Merge pull request #27454 from meeseeksmachine/auto-backport-of-pr-27434-on-v3.8.2-doc

rcomer · web-flow · commit d32a0e36f5a6 · 2023-12-06T20:06:02.000Z
Backport PR #27434 on branch v3.8.2-doc (FIX: Expand stairs plot-type entry intro (reattempt))
diff --git a/galleries/plot_types/basic/stairs.py b/galleries/plot_types/basic/stairs.py
@@ -3,7 +3,9 @@
 stairs(values)
 ==============
 
-See `~matplotlib.axes.Axes.stairs`.
+See `~matplotlib.axes.Axes.stairs` when plotting :math:`y` between
+:math:`(x_i, x_{i+1})`. For plotting :math:`y` at :math:`x`, see
+`~matplotlib.axes.Axes.step`.
 
 .. redirect-from:: /plot_types/basic/step
 """
