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.

Author chris.jerdonek
Recipients chris.jerdonek, docs@python
Date 2012-09-20.19:24:16
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1348169057.62.0.370171802379.issue15990@psf.upfronthosting.co.za>
In-reply-to
Content
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 ).
History
Date User Action Args
2012-09-20 19:24:17chris.jerdoneksetrecipients: + chris.jerdonek, docs@python
2012-09-20 19:24:17chris.jerdoneksetmessageid: <1348169057.62.0.370171802379.issue15990@psf.upfronthosting.co.za>
2012-09-20 19:24:17chris.jerdoneklinkissue15990 messages
2012-09-20 19:24:16chris.jerdonekcreate