René's URL Explorer Experiment

{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"[Doc]: Better document Axes.transData and other transXYZ attributes","articleBody":"### Documentation Link\n\n_No response_\n\n### Problem\n\nIt's documented in the tutorial https://matplotlib.org/stable/tutorials/advanced/transforms_tutorial.html#data-coordinates, but not very discoverable:\r\n\r\n- People search for it on Github:\r\n  https://github.com/matplotlib/matplotlib/graphs/traffic\r\n  ![grafik](https://user-images.githubusercontent.com/2836374/218993550-2d925037-2910-4fa2-970e-a57dc37ad23d.png)\r\n- Search does not yield useful results: https://matplotlib.org/stable/search.html?q=transData\r\n\r\nProblem: `transData` and the likes are only attributes set in a [private function]/(https://github.com/matplotlib/matplotlib/blob/39070aeaab732eca1b5b7f7b478fa8b72dab8507/lib/matplotlib/axes/_base.py#L910)\r\nAs such, they do not have a docstring and do not appear in the API documentation.\r\n\r\n\r\n\r\n\r\n\n\n### Suggested improvement\n\nAction: Find out, how to make this available in the API docs at https://github.com/matplotlib/matplotlib/blob/main/doc/api/axes_api.rst\r\n\r\nWorth checking:\r\n- https://www.sphinx-doc.org/en/master/usage/extensions/autodoc.html#directive-autoattribute\r\n- or manually: https://www.sphinx-doc.org/en/master/usage/restructuredtext/domains.html#directive-py-attribute\r\n\r\nAlternative: Turn the `trans*` attributes into properties. They can be documented properly and have the advantage of being read-only. This is a slight performance cost, but should be negligible compared to any action involving the transforms.","author":{"url":"https://github.com/timhoffm","@type":"Person","name":"timhoffm"},"datePublished":"2023-02-15T10:04:48.000Z","interactionStatistic":{"@type":"InteractionCounter","interactionType":"https://schema.org/CommentAction","userInteractionCount":12},"url":"https://github.com/25220/matplotlib/issues/25220"}