GH-99818: improve the documentation for zipfile.Path and Traversable (GH-101589)

Automerge-Triggered-By: GH:FFY00

diff --git a/Doc/library/importlib.resources.abc.rst b/Doc/library/importlib.resources.abc.rst
index 7747e89a833c02a678fbe38e660573656bde06c2..2d0f137ffc7996d01372f33a4a9cf1fa93c57ec6 100644 (file)
--- a/Doc/library/importlib.resources.abc.rst
+++ b/Doc/library/importlib.resources.abc.rst
@@ -89,9 +89,12 @@
 
 .. class:: Traversable
 
-    An object with a subset of pathlib.Path methods suitable for
+    An object with a subset of :class:`pathlib.Path` methods suitable for
     traversing directories and opening files.
 
+    For a representation of the object on the file-system, use
+    :meth:`importlib.resources.as_file`.
+
     .. versionadded:: 3.9
 
     .. deprecated-removed:: 3.12 3.14

diff --git a/Doc/library/zipfile.rst b/Doc/library/zipfile.rst
index 1c516723f04a3337ea2906fcec0e92b9e140b3fb..0195abc3a992c1bc5c587c053b3dafd0f83785b6 100644 (file)
--- a/Doc/library/zipfile.rst
+++ b/Doc/library/zipfile.rst
@@ -55,8 +55,9 @@ The module defines the following items:
 .. class:: Path
    :noindex:
 
-   A pathlib-compatible wrapper for zip files. See section
-   :ref:`path-objects` for details.
+   Class that implements a subset of the interface provided by
+   :class:`pathlib.Path`, including the full
+   :class:`importlib.resources.abc.Traversable` interface.
 
    .. versionadded:: 3.8