PR Summary

This example from the plot docstring was unclear and/or incorrect. This modifies in a way that I at least find clearer.

import numpy as np
import matplotlib.pyplot as plt

fig, (ax1, ax2, ax3) = plt.subplots(1,3, sharey=True, figsize=(10,5))
a = np.arange(6).reshape(3,2)
ax1.plot(a[0], a[1:], 'o-') #old example
ax2.plot(a, 'o-')
for i in range(2):
    ax3.plot(a[:, i], 'o-')
ax1.set_title('Old Example')
ax2.set_title('New Example - part 1')
ax3.set_title('New Example - part 2')
ax1.set_xlim(ax3.get_xlim())

See discussion on gitter starting here: https://gitter.im/matplotlib/matplotlib?at=5f80c4dfdc95072254c78916

PR Checklist

• [N/A] Has pytest style unit tests (and pytest passes).
• [N/A] Is Flake 8 compliant (run flake8 on changed files to check).
• [N/A] New features are documented, with examples if plot related.
• (as yet undetermined, allowing CI to build) Documentation is sphinx and numpydoc compliant (the docs should build without error).
• Conforms to Matplotlib style conventions (install flake8-docstrings and pydocstyle<4 and run flake8 --docstring-convention=all).
• [N/A] New features have an entry in doc/users/next_whats_new/ (follow instructions in README.rst there).
• [N/A] API changes documented in doc/api/next_api_changes/ (follow instructions in README.rst there).