René's URL Explorer Experiment

{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"Review documentation of Axes plotting methods","articleBody":"As a follow up of #7205, some docstrings of the basic Axes plotting methods could need a bit care. In particular:\r\n\r\n- Conversion to numpydoc format.\r\n- Improvements on the descriptions.\r\n\r\nI intend to go through the methods and update their docs. This is a summary issue to keep track of my progress: \r\n\r\n### Basic\r\n\r\n- [x] `Axes.plot`\r\n- [x] `Axes.errorbar`\r\n- [x] `Axes.scatter`\r\n- [x] `Axes.plot_date`\r\n- [x] `Axes.step`\r\n- [x] `Axes.loglog`\r\n- [x] `Axes.semilogx`\r\n- [x] `Axes.semilogy`\r\n- [x] `Axes.fill_between`\r\n- [x] `Axes.fill_betweenx`\r\n- [x] `Axes.bar`\r\n- [x] `Axes.barh`\r\n- [x] `Axes.stem`\r\n- [x] `Axes.eventplot`\r\n- [x] `Axes.pie`\r\n- [x] `Axes.stackplot`\r\n- [x] `Axes.broken_barh`\r\n- [x] `Axes.vlines`\r\n- [x] `Axes.hlines`\r\n- [x] `Axes.fill`\r\n\r\n### Spans\r\n\r\n- [x] `Axes.axhline`\r\n- [x] `Axes.axhspan`\r\n- [x] `Axes.axvline`\r\n- [x] `Axes.axvspan`\r\n\r\n### Spectral\r\n\r\n- [x] `Axes.acorr`\r\n- [x] `Axes.angle_spectrum`\r\n- [x] `Axes.cohere`\r\n- [x] `Axes.csd`\r\n- [x] `Axes.magnitude_spectrum`\r\n- [x] `Axes.phase_spectrum`\r\n- [x] `Axes.psd`\r\n- [x] `Axes.specgram`\r\n- [x] `Axes.xcorr`\r\n\r\n### Statistics\r\n\r\n- [x] `Axes.boxplot`\r\n- [x] `Axes.violinplot`\r\n- [x] `Axes.violin`\r\n- [x] `Axes.bxp`\r\n\r\n### Binned \r\n\r\n- [x] `Axes.hexbin`\r\n- [x] `Axes.hist`\r\n- [x] `Axes.hist2d`\r\n\r\n### Contours\r\n\r\n- [x] `Axes.clabel`\r\n- [x] `Axes.contour`\r\n- [x] `Axes.contourf`\r\n\r\n### Array\r\n\r\n- [x] `Axes.imshow`\r\n- [x] `Axes.matshow`\r\n- [x] `Axes.pcolor`\r\n- [x] `Axes.pcolorfast`\r\n- [x] `Axes.pcolormesh`\r\n- [x] `Axes.spy`\r\n\r\n### Unstructured triangles\r\n\r\n- [x] `Axes.tripcolor`\r\n- [x] `Axes.triplot`\r\n- [x] `Axes.tricontour`\r\n- [x] `Axes.tricontourf`\r\n\r\n### Text and Annotations\r\n\r\n- [x] `Axes.annotate`\r\n- [x] `Axes.text`\r\n- [x] `Axes.table`\r\n- [x] `Axes.arrow`\r\n\r\n### Fields\r\n\r\n- [x] `Axes.barbs`\r\n- [x] `Axes.quiver`\r\n- [x] `Axes.quiverkey`\r\n- [x] `Axes.streamplot`\r\n\r\n## Axes limits and direction\r\n\r\n- [x] `Axes.invert_xaxis`\r\n- [x] `Axes.xaxis_inverted`\r\n- [x] `Axes.invert_yaxis`\r\n- [x] `Axes.yaxis_inverted`\r\n- [x] `Axes.set_xlim`\r\n- [x] `Axes.get_xlim`\r\n- [x] `Axes.set_ylim`\r\n- [x] `Axes.get_ylim`\r\n- [x] `Axes.update_datalim`\r\n- [x] `Axes.update_datalim_bounds`\r\n- [x] `Axes.set_xbound`\r\n- [x] `Axes.get_xbound`\r\n- [x] `Axes.set_ybound`\r\n- [x] `Axes.get_ybound`\r\n\r\n## Axes scales\r\n\r\n- [x] `Axes.get_xscale`\r\n- [x] `Axes.set_xscale`\r\n- [x] `Axes.get_yscale`\r\n- [x] `Axes.set_yscale`\r\n\r\n\u003cs\u003eNote: I currently update the docstrings in my private branch https://github.com/timhoffm/matplotlib/tree/axes-plotting-docstrings and will provide a pull request once I'm done. I think this is better than opening a separate pull request for every change. Please let me know, in case you'd rather prefer many smaller PRs.\u003c/s\u003e\r\n\r\nThe fixes will be supplied in a series of PRs referencing this issue.\r\n\r\n  \r\n\r\n\r\n  \r\n  ","author":{"url":"https://github.com/timhoffm","@type":"Person","name":"timhoffm"},"datePublished":"2018-01-03T18:43:15.000Z","interactionStatistic":{"@type":"InteractionCounter","interactionType":"https://schema.org/CommentAction","userInteractionCount":11},"url":"https://github.com/10148/matplotlib/issues/10148"}