From 735ff5ae27fd417ef4dfdcbbbecb739ee4b73013 Mon Sep 17 00:00:00 2001
From: Shantanu <12621235+hauntsaninja@users.noreply.github.com>
Date: Sat, 25 Feb 2023 15:42:30 -0800
Subject: [PATCH] [3.11] GH-99818: improve the documentation for zipfile.Path
 and Traversable (GH-101589) (#102266)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Automerge-Triggered-By: GH:FFY00
(cherry picked from commit 84181c14040ed2befe7f1a55b4f560c80fa61154)

Co-authored-by: Filipe Laíns <lains@riseup.net>
---
 Doc/library/importlib.resources.abc.rst | 5 ++++-
 Doc/library/zipfile.rst                 | 5 +++--
 2 files changed, 7 insertions(+), 3 deletions(-)

diff --git a/Doc/library/importlib.resources.abc.rst b/Doc/library/importlib.resources.abc.rst
index a028537f3cb..4a563c8a539 100644
--- a/Doc/library/importlib.resources.abc.rst
+++ b/Doc/library/importlib.resources.abc.rst
@@ -86,9 +86,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
 
     .. attribute:: name
diff --git a/Doc/library/zipfile.rst b/Doc/library/zipfile.rst
index af1f2638555..9ad0a979e49 100644
--- 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