Backport PR matplotlib#27434: FIX: Expand stairs plot-type entry intro (reattempt)

story645 · meeseeksmachine · commit d3fc62707783 · 2023-12-06T17:12:21.000Z
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
 """
