Title: [Docs] add a new Sphinx `VersionChange` directive `.. scheduled-changed::` · Issue #131733 · python/cpython · GitHub
Open Graph Title: [Docs] add a new Sphinx `VersionChange` directive `.. scheduled-changed::` · Issue #131733 · python/cpython
X Title: [Docs] add a new Sphinx `VersionChange` directive `.. scheduled-changed::` · Issue #131733 · python/cpython
Description: Documentation Follow the discussion in #127405 (comment): No reason to actually use the word "deprecation" except to explain what process we're following for changing a user-visible and documented API. The change is added in PR #131717: ...
Open Graph Description: Documentation Follow the discussion in #127405 (comment): No reason to actually use the word "deprecation" except to explain what process we're following for changing a user-visible and documented ...
X Description: Documentation Follow the discussion in #127405 (comment): No reason to actually use the word "deprecation" except to explain what process we're following for changing a user-visible a...
Opengraph URL: https://github.com/python/cpython/issues/131733
X: @github
Domain: github.com
{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"[Docs] add a new Sphinx `VersionChange` directive `.. scheduled-changed::`","articleBody":"# Documentation\n\nFollow the discussion in https://github.com/python/cpython/issues/127405#issuecomment-2532875353:\n\n\u003e No reason to actually use the word \"deprecation\" except to explain what process we're following for changing a user-visible and documented API.\n\nThe change is added in PR #131717:\n\n- #131717\n\n```rst\n .. versionchanged:: 3.14\n A deprecation warning will be emitted if the :data:`sys.abiflags` member\n is accessed on Windows.\n\n The :data:`sys.abiflags` member will be set to a meaningful value on\n Windows in Python 3.16. This means the :data:`sys.abiflags` member will\n always be available on all platforms starting from Python 3.16.\n```\n\nA `.. versionchanged::` directive is not very accurate for this change. It would be nice to have a new directive `.. scheduled-changed::`:\n\n```rst\n .. scheduled-changed:: 3.14 3.16\n A deprecation warning will be emitted if the :data:`sys.abiflags` member\n is accessed on Windows.\n\n The :data:`sys.abiflags` member will be set to a meaningful value on\n Windows in Python 3.16. This means the :data:`sys.abiflags` member will\n always be available on all platforms starting from Python 3.16.\n```\n\nLike the `.. deprecated-removed::` directive:\n\nhttps://github.com/python/cpython/blob/8ada7a9e1435302ec2cb73375122072d0e1cdd6f/Doc/tools/extensions/changes.py#L76-L84","author":{"url":"https://github.com/XuehaiPan","@type":"Person","name":"XuehaiPan"},"datePublished":"2025-03-25T18:37:17.000Z","interactionStatistic":{"@type":"InteractionCounter","interactionType":"https://schema.org/CommentAction","userInteractionCount":2},"url":"https://github.com/131733/cpython/issues/131733"}
| route-pattern | /_view_fragments/issues/show/:user_id/:repository/:id/issue_layout(.:format) |
| route-controller | voltron_issues_fragments |
| route-action | issue_layout |
| fetch-nonce | v2:2ea9820f-1e97-96d3-f90b-ac84505ae1c1 |
| current-catalog-service-hash | 81bb79d38c15960b92d99bca9288a9108c7a47b18f2423d0f6438c5b7bcd2114 |
| request-id | E24C:91B93:5C247:7E84C:6A545D2E |
| html-safe-nonce | 5562fcf774ad26521f10bd22a13ec0edb136150667c8911189d4826d7c2e76b9 |
| visitor-payload | eyJyZWZlcnJlciI6IiIsInJlcXVlc3RfaWQiOiJFMjRDOjkxQjkzOjVDMjQ3OjdFODRDOjZBNTQ1RDJFIiwidmlzaXRvcl9pZCI6IjM5ODUyNTYyNTY4ODE1ODEzNTgiLCJyZWdpb25fZWRnZSI6ImlhZCIsInJlZ2lvbl9yZW5kZXIiOiJpYWQifQ== |
| visitor-hmac | 4f87eca4977f4f2f9e6347d8c6c18b422c10d3379e615b6adf95078b0bb01d80 |
| hovercard-subject-tag | issue:2947452748 |
| github-keyboard-shortcuts | repository,issues,copilot |
| google-site-verification | Apib7-x98H0j5cPqHWwSMm6dNU4GmODRoqxLiDzdx9I |
| octolytics-url | https://collector.github.com/github/collect |
| analytics-location | / |
| fb:app_id | 1401488693436528 |
| apple-itunes-app | app-id=1477376905, app-argument=https://github.com/_view_fragments/issues/show/python/cpython/131733/issue_layout |
| twitter:image | https://opengraph.githubassets.com/5a12929e9b0d23c6ca143ca0992a58e06967f66e9a000f33c1413470611a0a9c/python/cpython/issues/131733 |
| twitter:card | summary_large_image |
| og:image | https://opengraph.githubassets.com/5a12929e9b0d23c6ca143ca0992a58e06967f66e9a000f33c1413470611a0a9c/python/cpython/issues/131733 |
| og:image:alt | Documentation Follow the discussion in #127405 (comment): No reason to actually use the word "deprecation" except to explain what process we're following for changing a user-visible and documented ... |
| og:image:width | 1200 |
| og:image:height | 600 |
| og:site_name | GitHub |
| og:type | object |
| og:author:username | XuehaiPan |
| hostname | github.com |
| expected-hostname | github.com |
| None | b9a586c06a05a7a86fc7e3f4dbd03e42f6869085879aa184aa6369456dbd50fb |
| turbo-cache-control | no-preview |
| go-import | github.com/python/cpython git https://github.com/python/cpython.git |
| octolytics-dimension-user_id | 1525981 |
| octolytics-dimension-user_login | python |
| octolytics-dimension-repository_id | 81598961 |
| octolytics-dimension-repository_nwo | python/cpython |
| octolytics-dimension-repository_public | true |
| octolytics-dimension-repository_is_fork | false |
| octolytics-dimension-repository_network_root_id | 81598961 |
| octolytics-dimension-repository_network_root_nwo | python/cpython |
| turbo-body-classes | logged-out env-production page-responsive |
| disable-turbo | false |
| browser-stats-url | https://api.github.com/_private/browser/stats |
| browser-errors-url | https://api.github.com/_private/browser/errors |
| release | 6d28624802c2f7d9500239dd6870ed7031b7353b |
| ui-target | canary-2 |
| theme-color | #1e2327 |
| color-scheme | light dark |
Links:
Viewport: width=device-width