[3.12] Doc: Simplify the definition of 'soft deprecated' (GH-124988) (#125030)

(cherry picked from commit feca4cf64e9742b9c002d5533ced47e68b34a880)

Co-authored-by: Andrés Delfino <adelfino@gmail.com>
Co-authored-by: Sergey B Kirpichev <skirpichev@gmail.com>
Co-authored-by: Carol Willing <carolcode@willingconsulting.com>

diff --git a/Doc/glossary.rst b/Doc/glossary.rst
index f787015593079392581d21066c809ff625bf830d..b233967adc9e6a57206ab8d8ebf484d25251b442 100644 (file)
--- a/Doc/glossary.rst
+++ b/Doc/glossary.rst
@@ -1134,6 +1134,17 @@ Glossary
       when several are given, such as in ``variable_name[1:3:5]``.  The bracket
       (subscript) notation uses :class:`slice` objects internally.
 
+   soft deprecated
+      A soft deprecated API should not be used in new code,
+      but it is safe for already existing code to use it.
+      The API remains documented and tested, but will not be enhanced further.
+
+      Soft deprecation, unlike normal deprecation, does not plan on removing the API
+      and will not emit warnings.
+
+      See `PEP 387: Soft Deprecation
+      <https://peps.python.org/pep-0387/#soft-deprecation>`_.
+
    special method
       .. index:: pair: special; method