@JulienPalard @cocoatomo We'd like to mark some python-specific index-types deprecated obviously (accurately it has already been marked as deprecated in our document). It does not mean they will be removed right away. It will be removed in Sphinx-5.0 (maybe 2 years later). It seems python-doc contains some index entries (see @shimizukawa 's comment). Do you have any opinions for this idea?

@tk0miya Thanks for the heads up!

Would a proper fix looks like this python/cpython#18004?

If so, feel free to copy-past my seds to the page documenting this deprecation and how to fix it.

@tk0miya have you looked at #6970 (comment)?

Sorry for the late response. I found problems on i18n with this deprecation. The python index-types are translated on index pages automatically via language configuration.

For example, .. index: builtin: len is translated to the pair of "組み込み関数" and "len" in Japanese document. On the other hand, .. index:: pair: builtin: len is not translated. So it is displayed as pair of "builtin" and "len" even in Japanese docs.

We need to resolve this before the deprecation. So I withdraw this proposal for a while.

Sorry for bothering you.

Codecov Report

❗ No coverage uploaded for pull request base (master@1fc4e8c). Click here to learn what that means.
The diff coverage is n/a.

Resolved by #11412.