classification
Title: Add quick links table to argparse docs
Type: Stage: needs patch
Components: Documentation Versions: Python 3.5
process
Status: open Resolution:
Dependencies: Superseder:
Assigned To: docs@python Nosy List: Gaurav Tatke, docs@python, merwok, paul.j3, rhettinger, terry.reedy
Priority: normal Keywords: easy

Created on 2014-04-03 20:47 by rhettinger, last changed 2016-12-19 23:24 by Gaurav Tatke.

Files
File name Uploaded Description Edit
SampleOfSummaryTable.PNG Gaurav Tatke, 2016-12-19 23:24
Messages (4)
msg215468 - (view) Author: Raymond Hettinger (rhettinger) * (Python committer) Date: 2014-04-03 20:47
The argparse module has many functions and options.

It would benefit from a summary and quick links table at the top of the page just like we have for the itertools module docs and the builtins module docs.
msg215568 - (view) Author: Terry J. Reedy (terry.reedy) * (Python committer) Date: 2014-04-04 21:47
I have used both quick link tables and agree that more would be nice in spite of the added maintenance burden. The re module is one I would like to see indexed.
msg215858 - (view) Author: paul j3 (paul.j3) * Date: 2014-04-10 00:12
While 'argparse' is complex, its organization is quite different from 'itertools'.  For most purposes there is one starting point:

    parser = argparse.ArgumentParser(...)

Nearly everything else invokes a 'parser'  method.  Most complex and common is 'add_argument'.

Some summary tables might be useful, but 'itertools' might not be best model.
msg283653 - (view) Author: Gaurav Tatke (Gaurav Tatke) * Date: 2016-12-19 23:24
Hello All,

I would like to help with this issue. I am a beginner. I am attaching a 'SampleOfSummaryTable.PNG' file which I think is one way of organizing summary table.

I think if we put quick links of function parameters in summary table then it will make existing parameter quick links above detailed summary of each parameter as redundant.

Please let me know if this is okay.
History
Date User Action Args
2016-12-19 23:24:11Gaurav Tatkesetfiles: + SampleOfSummaryTable.PNG
nosy: + Gaurav Tatke
messages: + msg283653

2014-04-10 00:12:07paul.j3setnosy: + paul.j3
messages: + msg215858
2014-04-04 21:47:29terry.reedysetnosy: + terry.reedy
messages: + msg215568
2014-04-04 21:05:31merwoksetnosy: + merwok
2014-04-03 20:47:15rhettingercreate