René's URL Explorer Experiment

{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"Refactor legend documentation","articleBody":"@anntzer recently pointed out that we've got a lot of documentation on legends scattered throughout the website. Some has higher quality than others, some has mixed levels of user expertise, some are in unintuitive places. I'm putting a list that @anntzer collected below in case somebody wants to take a stab.\r\n\r\n---\r\n\r\nTutorial:\r\n- Legend guide: http://matplotlib.org/tutorials/intermediate/legend_guide.html#sphx-glr-tutorials-intermediate-legend-guide-py\r\nquite advanced, probably can use some rewriting but OK.\r\n\r\nExamples:\r\n- Legend demo: http://matplotlib.org/gallery/text_labels_and_annotations/legend_demo.html#sphx-glr-gallery-text-labels-and-annotations-legend-demo-py\r\nLooks somewhere between what this PR proposes and the legend guide.  I think this PR is a nice piece of work but I would suggest trying not to spread the same information too thinly across many examples; perhaps the three \"narrative\" legend examples/tutorials could be merged into two?\r\n- What's new in 0.98.4 legend: http://matplotlib.org/gallery/pyplots/whats_new_98_4_legend.html#sphx-glr-gallery-pyplots-whats-new-98-4-legend-py\r\nCan probably be deleted and the relevant features split across other examples.\r\n- Polar legend: http://matplotlib.org/gallery/pie_and_polar_charts/polar_legend.html#sphx-glr-gallery-pie-and-polar-charts-polar-legend-py\r\nCan probably deleted, there's nothing special about legends in polar plots.\r\n- Simple legend 1 and 2: http://matplotlib.org/gallery/userdemo/simple_legend01.html#sphx-glr-gallery-userdemo-simple-legend01-py http://matplotlib.org/gallery/userdemo/simple_legend02.html#sphx-glr-gallery-userdemo-simple-legend02-py\r\nShould probably be unified.\r\n- Legend picking: http://matplotlib.org/gallery/event_handling/legend_picking.html#sphx-glr-gallery-event-handling-legend-picking-py\r\nIs really about event handling so can stand by itself.\r\n- Figure legend: http://matplotlib.org/gallery/text_labels_and_annotations/figlegend_demo.html#sphx-glr-gallery-text-labels-and-annotations-figlegend-demo-py\r\nShould probably be rewritten to use a single legend for the whole figure...\r\n- Transparent, fancy legends: http://matplotlib.org/gallery/recipes/transparent_legends.html#sphx-glr-gallery-recipes-transparent-legends-py\r\nIs basically the default now... probably doesn't need to exist by itself.\r\n- Scatter legend: http://matplotlib.org/gallery/lines_bars_and_markers/scatter_with_legend.html#sphx-glr-gallery-lines-bars-and-markers-scatter-with-legend-py\r\nHeh, why not.\r\n- Legend using predefined labels: http://matplotlib.org/gallery/api/legend.html#sphx-glr-gallery-api-legend-py\r\n- and the change in #9451 \r\n\r\nSuggestions:\r\n- Add relevant documentation to address #8789 (i.e. the improper scaling of the legend handles with default values for the legend parameters)","author":{"url":"https://github.com/choldgraf","@type":"Person","name":"choldgraf"},"datePublished":"2017-10-17T16:32:36.000Z","interactionStatistic":{"@type":"InteractionCounter","interactionType":"https://schema.org/CommentAction","userInteractionCount":5},"url":"https://github.com/9458/matplotlib/issues/9458"}