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 eric.araujo
Recipients Akarys, docs@python, eric.araujo, ezio.melotti, mdk, willingc
Date 2021-11-13.19:55:47
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <>
If you search in the index, there is no entry like 'append (list method)', only 'append (sequence method)':
This goes to the reference docs, where list methods are documented indirectly by reference to the Sequence protocol described just above the list section:

The tutorial page lists all methods for people learning, with noindex markup to avoid pointing from the index to the reference:

The individual decisions make sense, but I think the results is not satisfactory: there is no reference to list.append (etc) in the index or the sphinx inventory (only 'list.sort' is there, from the entry in the library/stdtypes list section).  I think index markup should be added for all built-in types in the stdtypes page so that links are generated.  Alternatively, add a sphinx directive to register that a type matches the sequence (etc) protocol, so that index entries for all protocol methods can be generated automatically.
Date User Action Args
2021-11-13 19:55:47eric.araujosetrecipients: + eric.araujo, ezio.melotti, docs@python, willingc, mdk, Akarys
2021-11-13 19:55:47eric.araujosetmessageid: <>
2021-11-13 19:55:47eric.araujolinkissue45762 messages
2021-11-13 19:55:47eric.araujocreate