Message 219085 - Python tracker

➜

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	jgehrcke
Recipients	docs@python, eric.araujo, ezio.melotti, georg.brandl, jgehrcke
Date	2014-05-25.12:36:24
SpamBayes Score	-1.0
Marked as misclassified	Yes
Message-id	<[email protected]>
In-reply-to

Content
Currently, the tutorial for the list sort method does not show allowed arguments: list.sort() Sort the items of the list in place. (see e.g. https://docs.python.org/3.4/tutorial/datastructures.html) Is there a reason why we do not show the arguments there? For simplicity? One should note that a web search for Python's list methods ranks that page pretty high. We could list the defaults, as in the built-in help: L.sort(cmp=None, key=None, reverse=False) And could link to https://docs.python.org/2/library/functions.html#sorted for an explanation.

Currently, the tutorial for the list sort method does not show allowed arguments:


    list.sort()
        Sort the items of the list in place.

(see e.g. https://docs.python.org/3.4/tutorial/datastructures.html)

Is there a reason why we do not show the arguments there? For simplicity? One should note that a web search for Python's list methods ranks that page pretty high. We could list the defaults, as in the built-in help:

     L.sort(cmp=None, key=None, reverse=False)

And could link to https://docs.python.org/2/library/functions.html#sorted for an explanation.

History
Date	User	Action	Args
2014-05-25 12:36:25	jgehrcke	set	recipients: + jgehrcke, georg.brandl, ezio.melotti, eric.araujo, docs@python
2014-05-25 12:36:25	jgehrcke	set	messageid: <[email protected]>
2014-05-25 12:36:25	jgehrcke	link	issue21575 messages
2014-05-25 12:36:24	jgehrcke	create