Clarification on signature for `index`

Documentation

The documentation reads that the signature for index (sequences, str, bytes) is .index(value[, start[, end]]), (the name of the first parameter changes depending on the underlying type). This leaves it open to interpretation whether any/all the parameters can be named parameters (that they cannot). Should the signature of these methods be .index(sub[, start[, end]], /)?

Ref: https://docs.python.org/3/library/stdtypes.html#sequence.index

Note: Tried looking whether there is some convention that specifies that if there are optional parameters in brackets, this means that the parameters are positional only, but was unable to find anything.

Linked PRs

• gh-152092

先从所引用的 stdtypes.html 部分中的 sequence.index 文档开始，并在进行更改前查看链接的 PR gh-152092。确认其他地方如何记录仅限位置参数，然后确保索引签名清楚地传达所接受的调用形式。