I think we could make stairs/step a bit easier to navigate by adding a drop of roadmapping by changing the intro sentence in the stairs plot type entry:
to something that sets expectations for stairs and points folks to steps when appropriate. Something like:
See `~matplotlib.axes.Axes.stairs` when plotting $y$ between $(x_i, x_{i+1})$ and ~`matplotlib.axes.Axes.step` when plotting $y$ at $x$.
I think we could make stairs/step a bit easier to navigate by adding a drop of roadmapping by changing the intro sentence in the stairs plot type entry:
matplotlib/galleries/plot_types/basic/stairs.py
Line 6 in 879cf76
to something that sets expectations for stairs and points folks to steps when appropriate. Something like:
See `~matplotlib.axes.Axes.stairs` when plotting $y$ between $(x_i, x_{i+1})$ and ~`matplotlib.axes.Axes.step` when plotting $y$ at $x$.