This issue tracker has been migrated to GitHub, and is currently read-only.
For more information, see the GitHub FAQs in the Python's Developer Guide.

Author paul.j3
Recipients BGuo1, Daniel Stone, docs@python, paul.j3
Date 2016-03-23.21:31:41
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1458768701.65.0.131695568245.issue26602@psf.upfronthosting.co.za>
In-reply-to
Content
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.
History
Date User Action Args
2016-03-23 21:31:41paul.j3setrecipients: + paul.j3, docs@python, BGuo1, Daniel Stone
2016-03-23 21:31:41paul.j3setmessageid: <1458768701.65.0.131695568245.issue26602@psf.upfronthosting.co.za>
2016-03-23 21:31:41paul.j3linkissue26602 messages
2016-03-23 21:31:41paul.j3create