@layday do you have any suggestions?

I'd reword this completely - it's far too verbose and fails to get the message across:

    An abstract base class implementing :class:`importlib.abc.ResourceReader`
    for :class:`importlib.abc.Traversable` objects, and defining one
    abstract method, :meth:`files`, which must return such an object.
    Loaders are expected to implement this ABC for resource reading,
    instead of implementing :class:`importlib.abc.ResourceReader` directly,
    to interface with :meth:`importlib.resources.files`.

Document the files method:

.. abstractmethod:: files()

   An abstract method to return a :class:`importlib.abc.Traversable`
   instance for the package's resources.

Drag the ResourceReader section down underneath Traversable and remove the "superseded by" blurb from ResourceReader. The ResourceReader's description might also need adjusting.

https://bugs.python.org/issue45516 is closed. What is the status of this PR?

Hi @iritkatriel, it is still relevant, but I am not sure if I will pick this up again soon.

Ok, I reopened the issue on GitHub.

This PR is stale because it has been open for 30 days with no activity.

Documentation build overview

📚 cpython-previews | 🛠️ Build #35337793 | 📁 Comparing f4397cf against main (5b55b50)

  🔍 Preview build