Author zach.ware
Recipients docs@python, icedream91, r.david.murray, terry.reedy, zach.ware
Date 2013-07-05.19:58:45
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1373054326.28.0.629456302269.issue18326@psf.upfronthosting.co.za>
In-reply-to
Content
How about this patch?

I agree that "types of arguments/parameters" has great potential for confusion, so the glossary has been changed to "kinds of argument/parameter" (dropping the pluralization as well; it is unnecessary).  I think just taking the word "type" out of it makes the rest of each entry unambiguous.

To list.sort, I simply added a line: ":meth:`sort` accepts two arguments which can only be passed by keyword:".  I considered making each parameter's description an indented block after that, but that seems like more change than is really necessary, and the patched version doesn't look too bad to me.
History
Date User Action Args
2013-07-05 19:58:46zach.waresetrecipients: + zach.ware, terry.reedy, r.david.murray, docs@python, icedream91
2013-07-05 19:58:46zach.waresetmessageid: <1373054326.28.0.629456302269.issue18326@psf.upfronthosting.co.za>
2013-07-05 19:58:46zach.warelinkissue18326 messages
2013-07-05 19:58:46zach.warecreate