René's URL Explorer Experiment

{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"DOC: Add more explanatory comments to gallery examples","articleBody":" @erinleeryan raised the concern that many of the matplotlib gallery examples have very little to no prose documentation, which can be frustrating for users unfamiliar with matplotlib conventions. \r\nFor example, in the [stem plot example](https://matplotlib.org/gallery/lines_bars_and_markers/stem_plot.html#sphx-glr-gallery-lines-bars-and-markers-stem-plot-py) below it is unclear what markerline, stemlines, and baseline are relative the plot, and why `plt.stem` returns those three objects and what the `plt.setp` function is doing. \r\n\r\n```python\r\nimport matplotlib.pyplot as plt\r\nimport numpy as np\r\n\r\nx = np.linspace(0.1, 2 * np.pi, 10)\r\nmarkerline, stemlines, baseline = plt.stem(x, np.cos(x), '-.')\r\nplt.setp(baseline, color='r', linewidth=2)\r\n\r\nplt.show()\r\n```\r\n\r\nAs suggested by @erinleeryan, it would be a welcome improvement to the docs to add short one line comments explaining what each line is doing, as shown in the [pie chart](https://matplotlib.org/gallery/pie_and_polar_charts/pie_features.html#sphx-glr-gallery-pie-and-polar-charts-pie-features-py) example below:\r\n\r\n```python\r\n# Pie chart, where the slices will be ordered and plotted counter-clockwise:\r\nlabels = 'Frogs', 'Hogs', 'Dogs', 'Logs'\r\nsizes = [15, 30, 45, 10]\r\nexplode = (0, 0.1, 0, 0)  # only \"explode\" the 2nd slice (i.e. 'Hogs')\r\n\r\nfig1, ax1 = plt.subplots()\r\nax1.pie(sizes, explode=explode, labels=labels, autopct='%1.1f%%',\r\n        shadow=True, startangle=90)\r\nax1.axis('equal')  # Equal aspect ratio ensures that pie is drawn as a circle.\r\n\r\nplt.show()\r\n```\r\n\r\nAs an aside, we probably should also remove \"simple\" and \"basic\" from the titles of examples, as the gallery image will indicate the level of complexity of the example to the user. \r\n\r\n","author":{"url":"https://github.com/story645","@type":"Person","name":"story645"},"datePublished":"2018-07-13T22:54:58.000Z","interactionStatistic":{"@type":"InteractionCounter","interactionType":"https://schema.org/CommentAction","userInteractionCount":14},"url":"https://github.com/11654/matplotlib/issues/11654"}