Slicing in Wrong Place in Docs

[George-Ogden]

Documentation

Should the section about slicing go in the section below or somewhere else? It seems irrelevant here:
https://docs.python.org/3/reference/datamodel.html#object.__length_hint__

object.__length_hint__(self)
...
Added in version 3.4.

Note Slicing is done exclusively with the following three methods. A call like
a[1:2] = b
...

Linked PRs

• gh-145591: Move slicing note to subscription methods section #145606
• [3.14] gh-145591: Move slicing note to __getitem__ (GH-145606) #145760

[encukou]

The note is correct -- it starts with:

Slicing is done exclusively with the following three methods.

It applies to the following methods -- __getitem__, __setitem__, and __delitem__.

And it doesn't apply to __length_hint__ as it's not indented. I agree that this is confusing.
Maybe it should be moved into __getitem__, since the other two already refer back to __getitem__. (And the 3 methods it applies to should be named explicitly.)

[Towaiji]

Thanks for the clarification. I updated the linked PR to explicitly name __getitem__, __setitem__, and __delitem__, and kept the note under __getitem__ for context.

PR: #145606