[issue26602] argparse doc introduction is inappropriately targeted
paul j3
report at bugs.python.org
Wed Mar 23 17:31:41 EDT 2016
paul j3 added the comment:
By text and location the sidebar does not apply specifically to this example. It applies to the whole page, 'This page contains the API reference information.'
Documentation for argparse is indeed a problem - both because of its complexity and how it is used. Many other reference modules focus on the classes and their methods. This is organized about one class, the parser object, and a couple of its methods. It's really more of an advanced user's tutorial, making most sense to users who already have use optparse and getopt. For them that initial example is appropriate, selling them on the power of this parser.
For beginners I'd focus on the tutorial and its examples. Example or not this reference section can be overwhelming to beginning Python users.
----------
nosy: +paul.j3
_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue26602>
_______________________________________
More information about the Python-bugs-list
mailing list