[issue26602] argparse doc introduction is inappropriately targeted

2017-06-04 Thread Cheryl Sabella
Cheryl Sabella added the comment: If it helps at all, I first learned about argparse a few weeks ago. I first went to the doc page and then immediately went to the tutorial, as suggested. I didn't find it difficult or off-putting at all. In fact, I loved that there was a tutorial that it

[issue26602] argparse doc introduction is inappropriately targeted

2017-03-14 Thread Martin Panter
Martin Panter added the comment: The patch looks unfinished. I left some narrow nit-picky review comments, but I haven’t really thought about the problem from a high level. -- nosy: +martin.panter stage: -> patch review versions: +Python 2.7, Python 3.5, Python 3.6, Python 3.7

[issue26602] argparse doc introduction is inappropriately targeted

2016-03-23 Thread paul j3
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.

[issue26602] argparse doc introduction is inappropriately targeted

2016-03-22 Thread Brian Guo
Brian Guo added the comment: Hi, I agree with your observation about the unnecessarily complicated documentation. I feel that there is not a real necessity to include an example that uses (metavar='N', nargs='+') or even (const='sum', default='max') inside the parameters of the add_argument

[issue26602] argparse doc introduction is inappropriately targeted

2016-03-21 Thread Daniel Stone
New submission from Daniel Stone: The argparse documentation starts off, after a couple of sentences, by spending several paragraphs (and a couple of sentences) explaining this gem: import argparse parser = argparse.ArgumentParser(description='Process some integers.')