From 2a426abbc706d8ef3baba48893c12a43ee19beb2 Mon Sep 17 00:00:00 2001 From: Stan Ulbrych Date: Sun, 19 Apr 2026 20:23:13 +0100 Subject: [PATCH 1/2] Document `soft-deprecated` --- documentation/markup.rst | 13 +++++++++++++ 1 file changed, 13 insertions(+) diff --git a/documentation/markup.rst b/documentation/markup.rst index 863fe34443..27da4a36e8 100644 --- a/documentation/markup.rst +++ b/documentation/markup.rst @@ -1144,6 +1144,19 @@ units as well as normal text: .. deprecated-removed:: next 4.0 +.. describe:: soft-deprecated + + Indicates the version from which the described feature is :term:`soft deprecated`. + + There is one required argument: the version from which the feature is soft + deprecated. + Similarly to ``deprecated``, you should use the word ``next`` to indicate + the API will be first soft deprecated in the upcoming release. + + Example:: + + .. soft-deprecated:: next + .. describe:: impl-detail This directive is used to mark CPython-specific information. Use either with From 2635a069fa03c5edfa975cf212b515e3e650c607 Mon Sep 17 00:00:00 2001 From: Stan Ulbrych Date: Sun, 19 Apr 2026 20:59:13 +0100 Subject: [PATCH 2/2] Simplify Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com> --- documentation/markup.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/documentation/markup.rst b/documentation/markup.rst index 27da4a36e8..5ba8e4c7af 100644 --- a/documentation/markup.rst +++ b/documentation/markup.rst @@ -1150,8 +1150,8 @@ units as well as normal text: There is one required argument: the version from which the feature is soft deprecated. - Similarly to ``deprecated``, you should use the word ``next`` to indicate - the API will be first soft deprecated in the upcoming release. + Use the word ``next`` to indicate the API will be first soft deprecated in + the upcoming release. Example::