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。確認其他地方如何記錄僅限位置參數，然後確保索引簽名清楚地傳達所接受的呼叫形式。