Kieran Siek <kierans...@protonmail.com> added the comment: 7 years later I'd like to bring up essentially point #2 in this issue, which is the fact that additional list methods are :noindex: resulting in it being unlinked in the documentation.
Current state of affairs: 1. Common Sequence methods are documented at https://docs.python.org/3/library/stdtypes.html#common-sequence-operations, MutableSequence methods at https://docs.python.org/3/library/stdtypes.html#mutable-sequence-types. 2. Tuple methods do not have method directives and are just referred to the common sequence methods in the documentation text itself. 3. List methods have method directives with :noindex: at https://docs.python.org/3/tutorial/datastructures.html#more-on-lists 4. list.sort() has duplicate documentation at https://docs.python.org/3/library/stdtypes.html#list.sort, and the entry for list.sort() under 3) does not even link to the duplicate It is pretty inconsistent and frankly confusing. > I would be fine with adding mostly empty method directives to make links > work, without duplicating the info in the existing “common sequence > operations” table and footnotes. Eric mentions this, but then the situation would either be: 1. Tuple methods link to common sequence methods, list methods link to the More on Lists version of the Data Structures tutorial or 2. Tuple methods and list methods both link to common sequence methods, and ??? to the More on Lists version which is still inconsistent. Another solution would be to move list method documentation to under the list class (where the duplicate list.sort() is), but in this case the tutorial would be affected as well. I don't see a clear solution here, but I think it's very worth rethinking. ---------- nosy: +kosayoda versions: +Python 3.10, Python 3.11, Python 3.6, Python 3.7, Python 3.8, Python 3.9 _______________________________________ Python tracker <rep...@bugs.python.org> <https://bugs.python.org/issue11975> _______________________________________ _______________________________________________ Python-bugs-list mailing list Unsubscribe: https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
