René's URL Explorer Experiment

{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"Move typing-related usage of PEP585 generics from `typing` docs to `collections.abc`","articleBody":"# Documentation\r\n\r\nAs pointed out in #123521, currently we have typing-related usage of PEP585 generics (`Generator`, `Callable`, `Coroutine`, etc.) explained on [`typing`](https://docs.python.org/3/library/typing.html#typing.Generator) page. However, those aliases are deprecated, and there's no backlink from their `collections.abc` [counterparts](https://docs.python.org/3/library/collections.abc.html#collections.abc.Generator).\r\n\r\nSo, currently all users of the recommended modern option (`collections.abc` generics) have no documentation regarding their use in typing context at hand. Worse, classes there don't even have their generic arguments listed - only the name:\r\n\r\n\u003e `class collections.abc.Generator`\r\n\r\nThis clearly should be fixed. At minimum the following needs to hold:\r\n\r\n* `collections.abc` aliases have their generic arguments listed in the docs\r\n* All typing-related info from corresponding `typing` docs entries should be reachable from `collections.abc` docs.\r\n\r\nUpon some thinking I agree with @ZeroIntensity that moving all information to `collections.abc` and only retaining deprecation warning with a link in `typing` docs could be the most ergonomic option.\r\n\n\n\u003c!-- gh-linked-prs --\u003e\n### Linked PRs\n* gh-123544\n* gh-123790\n* gh-123792\n\u003c!-- /gh-linked-prs --\u003e\n","author":{"url":"https://github.com/sterliakov","@type":"Person","name":"sterliakov"},"datePublished":"2024-08-31T00:11:22.000Z","interactionStatistic":{"@type":"InteractionCounter","interactionType":"https://schema.org/CommentAction","userInteractionCount":3},"url":"https://github.com/123523/cpython/issues/123523"}