Message 153491 - Python tracker

➜

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.

In-reply-to
Author	tshepang
Recipients	docs@python, tshepang
Date	2012年02月16日.18:34:21
SpamBayes Score	0.00012614416
Marked as misclassified	No
Message-id	<1329417262.26.0.419020263055.issue14034@psf.upfronthosting.co.za>

Content
The argparse example (http://docs.python.org/dev/library/argparse.html#example) introduces way too many concepts too early. It's written as if targeted to existing users of optparse, instead of newcomers to Python's CLI handling. Perhaps the example could be more gentle, or if there is insistence on showing off, maybe the page could be kept as-is, but with a link to some tutorial (as is done with logging: http://docs.python.org/dev/library/logging.html).

Content

The argparse example (http://docs.python.org/dev/library/argparse.html#example) introduces way too many concepts too early. It's written as if targeted to existing users of optparse, instead of newcomers to Python's CLI handling.
Perhaps the example could be more gentle, or if there is insistence on showing off, maybe the page could be kept as-is, but with a link to some tutorial (as is done with logging: http://docs.python.org/dev/library/logging.html).

History
Date	User	Action	Args
2012年02月16日 18:34:22	tshepang	set	recipients: + tshepang, docs@python
2012年02月16日 18:34:22	tshepang	set	messageid: <1329417262.26.0.419020263055.issue14034@psf.upfronthosting.co.za>
2012年02月16日 18:34:21	tshepang	link	issue14034 messages
2012年02月16日 18:34:21	tshepang	create

homepage