From 83ddb00bd5d21e4528df6fd3a17b1ab254d3b4eb Mon Sep 17 00:00:00 2001
From: Steve Dower <steve.dower@python.org>
Date: Thu, 16 Oct 2025 17:17:36 +0100
Subject: [PATCH 1/2] Add documentation for Python install manager's
 install_dir, global_dir and download_dir

---
 Doc/using/windows.rst | 19 +++++++++++++++++++
 1 file changed, 19 insertions(+)

diff --git a/Doc/using/windows.rst b/Doc/using/windows.rst
index 0b98cfb8d270a4..91594ef08f2da2 100644
--- a/Doc/using/windows.rst
+++ b/Doc/using/windows.rst
@@ -457,6 +457,25 @@ customization.
      - Specify the default format used by the ``py list`` command.
        By default, ``table``.
 
+   * - ``install_dir``
+     - (none)
+     - Specify the root directory that runtimes will be installed into.
+       Previously installed runtimes will not be usable unless moved to the new
+       location.
+
+   * - ``global_dir``
+     - (none)
+     - Specify the directory where global commands (such as ``python3.14.exe``)
+       are stored.
+       This directory should be added to your :envvar:`PATH` to make the
+       commands available from your terminal.
+
+   * - ``download_dir``
+     - (none)
+     - Specify the directory where downloaded files are stored.
+       This directory is a temporary cache, and can be cleaned up from time to
+       time.
+
 Dotted names should be nested inside JSON objects, for example, ``list.format``
 would be specified as ``{"list": {"format": "table"}}``.
 

From 4800295dea12340d3072de9171a6b6269c79a027 Mon Sep 17 00:00:00 2001
From: Steve Dower <steve.dower@python.org>
Date: Wed, 22 Oct 2025 00:20:51 +0100
Subject: [PATCH 2/2] Clarification

---
 Doc/using/windows.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/Doc/using/windows.rst b/Doc/using/windows.rst
index 91594ef08f2da2..e6619b73bd2c26 100644
--- a/Doc/using/windows.rst
+++ b/Doc/using/windows.rst
@@ -460,8 +460,8 @@ customization.
    * - ``install_dir``
      - (none)
      - Specify the root directory that runtimes will be installed into.
-       Previously installed runtimes will not be usable unless moved to the new
-       location.
+       If you change this setting, previously installed runtimes will not be
+       usable unless you move them to the new location.
 
    * - ``global_dir``
      - (none)