gh-105189: fix importlib.resources.abc deprecation docs

[graingert]

• Issue: importlib.resources.abc.TraversableResources says it is deprecated in favour of itself #105189

---

📚 Documentation preview 📚: https://cpython-previews--105232.org.readthedocs.build/

[graingert]

what to do about importlib.resources.abc.ResourceReader it seems it's supposed to be deprecated, but there's no deprecation warning in the source code

[graingert]

preview is here: https://cpython-previews--105232.org.readthedocs.build/en/105232/library/importlib.html#importlib.abc.ResourceReader

[graingert]

the versionadded entries are incorrect on the 3.11 doc pages https://docs.python.org/3.11/library/importlib.resources.abc.html#importlib.resources.abc.TraversableResources

[serhiy-storchaka]

Concur with @graingert that separate versionadded directive for classes are not needed if they duplicate the module level versionadded.

I think that rather than duplicating documentation in importlib.rst (it can became de-synchronized), it would be enough to add minimal class declarations followed by references to new classes.

[hugovk]

@graingert Would be great to get this ready for 3.12.0 final in a couple of weeks. Thanks!

[hugovk]

Thank you!

[miss-islington]

Thanks @graingert for the PR, and @hugovk for merging it 🌮🎉.. I'm working now to backport this PR to: 3.12.
🐍🍒⛏🤖

[bedevere-app]

GH-109363 is a backport of this pull request to the 3.12 branch.

[hugovk]

the versionadded entries are incorrect on the 3.11 doc pages https://docs.python.org/3.11/library/importlib.resources.abc.html#importlib.resources.abc.TraversableResources

Do we need a separate PR to fix this bit in 3.11?

[graingert]

@hugovk yeah I think so

[hugovk]

@graingert Would you like to do the honours? :)