René's URL Explorer Experiment

{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"Allow `.. versionadded:: next` in docs","articleBody":"# Feature or enhancement\r\n\r\n### Proposal:\r\n\r\nIn a PR to CPython, the `versionadded`, `versionchanged`, `versionremoved`, `deprecated`, `deprecated-removed` directives in documentation should currently be set to the upcoming release.\r\n\r\nThis is inconvenient:\r\n- the numbers need to be changed in backports\r\n- if a PR misses a feature release, the number needs to be updated\r\n\r\nIt would be good to treat this more like News entries, which live in a `next/` directory before a release, when the release manager bundles them up and assigns a version.\r\n\r\nConcrete proposal:\r\n\r\n- [x] Teach `versionadded` \u0026 the others to expand the version argument `next` to `\u003cversion\u003e (unreleased)` (e.g. `3.14.0b0 (unreleased)`).\r\n- [x] Add a tool that replaces the `next` with a given string (e.g. `3.14`).\r\n- [x] Modify the release manager tooling to run the tool on release.\r\n- [x] Add a check to release manager tooling that *built* HTML documentation for a fresh release does not include the string `(unreleased)`. The RM should be able to skip this test, in case of a false positive.\r\n- [x] Update the Devguide.\r\n- [x] Announce in Discourse\r\n\r\n\r\n### Has this already been discussed elsewhere?\r\n\r\nI have already discussed this feature proposal on Discourse\r\n\r\n### Links to previous discussion of this feature:\r\n\r\nhttps://discuss.python.org/t/automating-versionadded-changed-markers-in-docs-to-expedite-prs/38423\r\n\r\n\u003c!-- gh-linked-prs --\u003e\r\n### Linked PRs\r\n* gh-121278\r\n* gh-124623\r\n* gh-124718\n* gh-125980\n* gh-127827\n* gh-127867\n* gh-128117\n\u003c!-- /gh-linked-prs --\u003e\r\n\r\n### Related PRs\r\n\r\n* release-tools PR: https://github.com/python/release-tools/pull/164\r\n* devguide PR: https://github.com/python/devguide/pull/1413\r\n\r\n### Discourse announcement\r\n\r\n* https://discuss.python.org/t/versionadded-next/65280","author":{"url":"https://github.com/encukou","@type":"Person","name":"encukou"},"datePublished":"2024-07-02T17:08:37.000Z","interactionStatistic":{"@type":"InteractionCounter","interactionType":"https://schema.org/CommentAction","userInteractionCount":10},"url":"https://github.com/121277/cpython/issues/121277"}