[issue40576] Align docs for list.sort, sorted, and on the website

2020-05-09 Thread Sam Lijin
Sam Lijin added the comment: I do clarify that they're not the same thing and that `sorted` accepts any iterable: https://github.com/python/cpython/pull/20017/files#diff-30d76a3dc0c885f86917b7d307ccf279 -- ___ Python tracker &

[issue40576] Align docs for list.sort, sorted, and on the website

2020-05-09 Thread Sam Lijin
Change by Sam Lijin : -- keywords: +patch pull_requests: +19327 stage: -> patch review pull_request: https://github.com/python/cpython/pull/20017 ___ Python tracker <https://bugs.python.org/issu

[issue40576] Align docs for list.sort, sorted, and on the website

2020-05-09 Thread Sam Lijin
New submission from Sam Lijin : It's mildly confusing to see `pydoc sorted` and `pydoc list.sort` to look so different, esp. since sorted just delegates to list.sort. By extension, https://docs.python.org/3/library/functions.html#sorted should also be aligned with this, but I'm