GH-108009: Add clarification of parser and argument defaults in argparse docs (#124154)

savannahostrowski · CAM-Gerlach · web-flow · commit 95f6e1275b1c · 2025-11-05T22:46:30.000Z
Co-authored-by: C.A.M. Gerlach &lt;CAM.Gerlach@Gerlach.CAM&gt;
diff --git a/Doc/library/argparse.rst b/Doc/library/argparse.rst
@@ -2070,7 +2070,9 @@ Parser defaults
      >>> parser.parse_args(['736'])
      Namespace(bar=42, baz='badger', foo=736)
 
-   Note that parser-level defaults always override argument-level defaults::
+   Note that defaults can be set at both the parser level using :meth:`set_defaults`
+   and at the argument level using :meth:`add_argument`. If both are called for the
+   same argument, the last default set for an argument is used::
 
      >>> parser = argparse.ArgumentParser()
      >>> parser.add_argument('--foo', default='bar')
