Reframe docs to focus on exception

Author: savannahostrowski

Doc/library/argparse.rst

@@ -1927,9 +1927,9 @@ Argument groups
    in the usual "positional arguments" and "optional arguments" sections.
 
    .. deprecated-removed:: 3.11 3.14
-      Calling :meth:`add_argument_group` on an argument group has been removed.
-      This feature was never supported and did not always work correctly.
-      The function existed on the API by accident through inheritance.
+      Calling :meth:`add_argument_group` on an argument group now raises an
+      exception. This nesting was never supported, often failed to work
+      correctly, and was unintentionally exposed through inheritance.
 
    .. deprecated:: 3.14
       Passing prefix_chars_ to :meth:`add_argument_group`
@@ -1994,9 +1994,9 @@ Mutual exclusion
 
    .. deprecated-removed:: 3.11 3.14
       Calling :meth:`add_argument_group` or :meth:`add_mutually_exclusive_group`
-      on a mutually exclusive group has been removed. These features were never
-      supported and did not always work correctly. The functions existed on the
-      API by accident through inheritance.
+      on a mutually exclusive group now raises an exception. This nesting was
+      never supported, often failed to work correctly, and was unintentionally
+      exposed through inheritance.
 
 
 Parser defaults

Doc/whatsnew/3.14.rst

@@ -644,8 +644,8 @@ argparse
 * Calling :meth:`~argparse.ArgumentParser.add_argument_group` on an argument
   group, and calling :meth:`~argparse.ArgumentParser.add_argument_group` or
   :meth:`~argparse.ArgumentParser.add_mutually_exclusive_group` on a mutually
-  exclusive group have been removed. This nesting was never supported, did
-  not always work correctly, and existed in the API by accident through
+  exclusive group now raise exceptions. This nesting was never supported,
+  often failed to work correctly, and was unintentionally exposed through
   inheritance. This functionality has been deprecated since Python 3.11.
   (Contributed by Savannah Ostrowski in :gh:`127186`.)
 

Misc/NEWS.d/next/Core_and_Builtins/2024-11-23-04-54-42.gh-issue-127133.WMoJjF.rst

@@ -1,6 +1,6 @@
 Calling :meth:`argparse.ArgumentParser.add_argument_group` on an argument group,
 and calling :meth:`argparse.ArgumentParser.add_argument_group` or
 :meth:`argparse.ArgumentParser.add_mutually_exclusive_group` on a mutually
-exclusive group have been removed. This nesting was never supported, did not
-always work correctly, and existed in the API by accident through inheritance.
+exclusive group now raise exceptions. This nesting was never supported, often
+failed to work correctly, and was unintentionally exposed through inheritance.
 This functionality has been deprecated since Python 3.11.