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 ezio.melotti
Recipients Arfrever, chris.jerdonek, docs@python, ezio.melotti, gvanrossum, mark.dickinson, terry.reedy
Date 2012-11-21.15:18:08
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1353511089.03.0.786326520551.issue15990@psf.upfronthosting.co.za>
In-reply-to
Content
On one hand it's good to have individual entries that can be referenced.
On the other hand I think it's important that people get the full picture, and having these definitions sparse in 4 or more distinct glossary entries doesn't help IMHO -- even if the reader follows all the cross-links.

I think it would be better to have a single entry somewhere (e.g. in the FAQs -- maybe it's too "advanced" for the tutorial), that:
  * explains the difference between arguments (what you pass) and parameters (what the function accepts);
  * lists the 5 kinds of parameters, providing an example for each;
  * lists the 2 kinds of arguments, providing an example for each;

I see 3 options here:
  1) we make this section and keep stub entries that link to it;
  2) we repeat the informations in both places (section and entries);
  3) we just keep the glossary entries;

If we pick 1 people might have to follow one more link.  Having a single "parameters and arguments" entry in the glossary might make this better by avoiding a redirect.
If we pick 2 there's duplication, and that's bad.
If we pick 3 I think we could at least explain the kinds of arguments in the "argument" entry and having stubs for "keyword args" and "positional args".  This will leave us with only two entries ("argument" and "parameter"), and with the initial problem that we don't know where to put the explanation of the difference between the two (in both? in a new entry? somewhere else? no parallel?).
History
Date User Action Args
2012-11-21 15:18:09ezio.melottisetrecipients: + ezio.melotti, gvanrossum, terry.reedy, mark.dickinson, Arfrever, chris.jerdonek, docs@python
2012-11-21 15:18:09ezio.melottisetmessageid: <1353511089.03.0.786326520551.issue15990@psf.upfronthosting.co.za>
2012-11-21 15:18:09ezio.melottilinkissue15990 messages
2012-11-21 15:18:08ezio.melotticreate