Address PR comments

Author: savannahostrowski

Doc/library/argparse.rst

@@ -2167,41 +2167,26 @@ Registering custom types or actions
 
 .. method:: ArgumentParser.register(registry_name, value, object)
 
-   It is possible to register custom actions, types, or other objects with
-   a parser using :meth:`!register`. This method is called when the action is
-   added to the parser. :meth:`!register` takes in the following arguments:
+   Sometimes it's desirable to use a custom string in error messages to provide
+   more user-friendly output. In these cases, :meth:`!register` can be used to
+   register custom actions or types with a parser and allow you to reference the
+   type by their registered name instead of their callable name.
 
-   * *registry_name* - the name of the internal registry where the object
-     will be stored (e.g. ``action``, ``type``).
-
-   * *value* - the key under which the object will be registered.
-
-   * *object* - the callable object to be registered.
+   The :meth:`!register` method accepts three arguments - a *registry_name*,
+   specifying the internal registry where the object will be stored (e.g.,
+   ``action``, ``type``), *value*, which is the key under which the object will
+   be registered, and object, the callable to be registered.
 
    The following example shows how to register a custom type with a parser::
 
       >>> import argparse
-      >>> import enum
-      >>> class WinterMonths(enum.StrEnum):
-      ...     JAN = 'January'
-      ...     FEB = 'February'
-      ...     DEC = 'December'
-      ...
-      >>> WinterMonths.__name__ = 'Winter Month'
       >>> parser = argparse.ArgumentParser()
-      >>> parser.register('type', 'Winter Month', WinterMonths)
-      >>> parser.add_argument('--month', type=WinterMonths, action='store')
-      _StoreAction(option_strings=['--month'], dest='month', nargs=None, const=None, default=None, type=<enum 'Winter Month'>, choices=None, required=False, help=None, metavar=None, deprecated=False)
-      >>> parser.parse_args(['--month','January'])
-      Namespace(month=<Winter Month.JAN: 'January'>)
-      >>> parser.parse_args(['--month','March'])
-      usage: python.exe -m _pyrepl [-h] [--month MONTH]
-      python.exe -m _pyrepl: error: argument --month: invalid Winter Month value: 'March'
-
-   In this example, :meth:`!register` allows the type converter to be
-   referenced by its registered name instead of the class name. This approach
-   can improve error message clarity and provide more user-friendly output.
-
+      >>> parser.register('type', 'hexadecimal integer', lambda s: int(s, 16))
+      >>> parser.add_argument('--foo', type='hexadecimal integer')
+      _StoreAction(option_strings=['--foo'], dest='foo', nargs=None, const=None, default=None, type='hexadecimal integer', choices=None, required=False, help=None, metavar=None, deprecated=False)
+      >>> parser.parse_args(['--foo', '1.2'])
+      usage: PROG [-h] [--foo FOO]
+      PROG: error: argument --foo: invalid 'hexadecimal integer' value: '1.2'
 
 Exceptions
 ----------