René's URL Explorer Experiment

{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"[Doc]: More consistent documentation of margins","articleBody":"### Documentation Link\r\n\r\nhttps://matplotlib.org/devdocs/api/_as_gen/matplotlib.axes.Axes.margins.html\r\n\r\n### Problem\r\n\r\nFrom https://github.com/matplotlib/matplotlib/pull/20942#discussion_r698618631:\r\n\r\n`Axes.margins` is not quite clear.\r\n\r\n\r\n\r\n### Suggested improvement\r\n\r\nActions:\r\n\r\n- Synchronize with `set_xmargin` / `set_ymargin`\r\n- Bring in context (link?) with view limits (`set_xlim`, `set_ylim`)\r\n- \u003cs\u003eNote that the view limits are only updated in the next `autoscale_view`. Margins only stall the view.\u003c/s\u003e Not true anymore, accessing lims unstalls them.\r\n- Maybe add explanation docs on how limits are handled.\r\n  Include / consolidate the following and cross-link from the API docs:\r\n  - https://matplotlib.org/stable/gallery/subplots_axes_and_figures/axes_margins.html\r\n  - https://matplotlib.org/stable/users/explain/axes/autoscale.html\r\n\r\n### Matplotlib Version\r\n\r\n3.4.x\r\n\r\n### Matplotlib documentation version\r\n\r\n3.4.x","author":{"url":"https://github.com/timhoffm","@type":"Person","name":"timhoffm"},"datePublished":"2021-09-02T21:44:52.000Z","interactionStatistic":{"@type":"InteractionCounter","interactionType":"https://schema.org/CommentAction","userInteractionCount":3},"url":"https://github.com/20984/matplotlib/issues/20984"}