René's URL Explorer Experiment

{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"Enforce the use of `deprecated-removed` in docs","articleBody":"In the docs we have two directives that can be used to [document deprecations](https://devguide.python.org/documenting/#paragraph-level-markup): `deprecated` and `deprecated-removed`.\r\n\r\nI think we should always prefer the latter:\r\n* it will make it easier to track and document removals\r\n* it will give people a target, so they can plan around it\r\n\r\nEven if the removal version gets postponed, it's better to postpone than to say that something is deprecated and then just remove it at an unspecified time in the future.\r\n\r\nCurrently `deprecated` is more commonly used:\r\n```\r\n$ grep -r 'deprecated::' --include=*.rst | wc -l\r\n226\r\n$ grep -r 'deprecated-removed::' --include=*.rst | wc -l\r\n30\r\n```\r\n\r\n- [ ] set removal version for deprecated features using `deprecated-removed`\r\n- [ ] automate the documentation of deprecations (see also #92308)\r\n- [ ] possibly deprecate the `deprecated` directive and replace it with `deprecated-removed`","author":{"url":"https://github.com/ezio-melotti","@type":"Person","name":"ezio-melotti"},"datePublished":"2022-05-09T15:31:15.000Z","interactionStatistic":{"@type":"InteractionCounter","interactionType":"https://schema.org/CommentAction","userInteractionCount":12},"url":"https://github.com/92564/cpython/issues/92564"}