René's URL Explorer Experiment

{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"Annotation change from \"s\" to \"text\" in 3.0- documentation","articleBody":"\r\n\r\n### Bug report\r\n\r\n**Bug summary**\r\nAnnotation argument has changed from 2.2.3 to 3.0 but I do not think it has been fully documented.\r\n\r\nThe documentation here is not to date with `s` still the keyword shown in parameter list (although it has `text` in the definition)  https://matplotlib.org/api/_as_gen/matplotlib.axes.Axes.annotate.html#matplotlib.axes.Axes.annotate \r\n\r\n\r\n\r\n**Code for reproduction**\r\n\r\n```\r\n#!/usr/bin/env python\r\nimport matplotlib\r\nimport sys\r\nprint(sys.version)\r\nprint(matplotlib.__version__)\r\nimport matplotlib.pyplot as plt\r\n\r\nplt.figure()\r\na = plt.annotate(s=\"test\", xy=(0.5, 0.5))\r\nprint(a)\r\n```\r\n\r\n**Actual outcome**\r\nHere is the outcome in two different version of matplotlib.\r\n```\r\n/home/jneal/miniconda3/envs/py36/bin/python /home/jneal/Phd/Codes/annotatetest.py\r\n3.6.4 |Anaconda, Inc.| (default, Jan 16 2018, 18:10:19) \r\n[GCC 7.2.0]\r\n2.2.3\r\nAnnotation(0.5,0.5,'test')\r\n\r\nProcess finished with exit code 0\r\n```\r\nand\r\n```\r\n3.6.4 |Anaconda, Inc.| (default, Jan 16 2018, 18:10:19) \r\n[GCC 7.2.0]\r\n3.0.0\r\nTraceback (most recent call last):\r\n  File \"annotatetest.py\", line 10, in \u003cmodule\u003e\r\n    a = plt.annotate(s=\"test\", xy=(0.5, 0.5))\r\nTypeError: annotate() missing 1 required positional argument: 'text'\r\n```\r\n\r\n\r\n**Expected outcome**\r\nI did not expect it to have changed. \r\n\r\nIf I change `s` to `text` then I have the same problem in reverse if trying to use both versions\r\n( I do know that the arg name can be omitted)\r\n\r\n**Matplotlib version**\r\nconda installed matplotlib  from conda-forge\r\n\u003c!--Please tell us how you installed matplotlib and python e.g., from source, pip, conda--\u003e\r\n\u003c!--If you installed from conda, please specify which channel you used if not the default--\u003e\r\n\r\n","author":{"url":"https://github.com/jason-neal","@type":"Person","name":"jason-neal"},"datePublished":"2018-09-28T17:45:34.000Z","interactionStatistic":{"@type":"InteractionCounter","interactionType":"https://schema.org/CommentAction","userInteractionCount":3},"url":"https://github.com/12325/matplotlib/issues/12325"}