From d7a0b6f8ca7dd3ae99ae3455e364502d645edd93 Mon Sep 17 00:00:00 2001
From: Harshit Sharma <66710144+harshitethic@users.noreply.github.com>
Date: Tue, 13 Oct 2026 06:36:08 +0530
Subject: [PATCH] docs: include pip index configuration in PyPI migration guide

---
 source/guides/migrating-to-pypi-org.rst | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/source/guides/migrating-to-pypi-org.rst b/source/guides/migrating-to-pypi-org.rst
index 2b565e8eef..a2128dd28d 100644
--- a/source/guides/migrating-to-pypi-org.rst
+++ b/source/guides/migrating-to-pypi-org.rst
@@ -135,6 +135,21 @@ Downloading packages
 
 ``pypi.org`` is the default host for downloading packages.
 
+Check for an old index URL in your pip configuration as well as in your upload
+tool configuration. For example, an old :file:`pip.conf` (or :file:`pip.ini`
+on Windows) might contain:
+
+.. code-block:: ini
+
+    [global]
+    index-url = https://pypi.python.org/pypi/
+
+Remove that override to use pip's current default index, or update it to
+``https://pypi.org/simple/``. Run ``python -m pip config debug`` to find
+which pip configuration files are active and where an override comes from.
+Keep intentional custom package-index or mirror settings unchanged.
+
+
 Managing published packages and releases
 ----------------------------------------