[New-bugs-announce] [issue14034] the example in argparse doc is too complex
report at bugs.python.org
Thu Feb 16 19:34:22 CET 2012
New submission from Tshepang Lekhonkhobe <tshepang at gmail.com>:
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).
assignee: docs at python
nosy: docs at python, tshepang
title: the example in argparse doc is too complex
versions: Python 2.7, Python 3.2, Python 3.3
Python tracker <report at bugs.python.org>
More information about the New-bugs-announce