Message170834
There is currently some ambiguity in our documentation around positional and keyword arguments (e.g. whether positional means "position-only" or "non-keyword" (roughly) and whether various terms and definitions should be for the calling syntax or the function definition syntax or both). For example, see the python-dev thread starting here:
http://mail.python.org/pipermail/python-dev/2012-September/121760.html
It would be good to nail down the preferred terminology in a central place. I would suggest that the glossary is a good place to start.
For example, when there is a question about what phrase an error message should use or how an error message should be interpreted, it would be good if (at least going forward) the glossary could be used as a definitive resource.
This issue may involve making a distinction in our terminology "between arguments (what you pass, call syntax) and parameters (what the function receives, function definition syntax)" (see http://mail.python.org/pipermail/python-dev/2012-September/121771.html ). |
|
Date |
User |
Action |
Args |
2012-09-20 19:24:17 | chris.jerdonek | set | recipients:
+ chris.jerdonek, docs@python |
2012-09-20 19:24:17 | chris.jerdonek | set | messageid: <1348169057.62.0.370171802379.issue15990@psf.upfronthosting.co.za> |
2012-09-20 19:24:17 | chris.jerdonek | link | issue15990 messages |
2012-09-20 19:24:16 | chris.jerdonek | create | |
|