diff --git a/docs/html/development/architecture/index.rst b/docs/html/development/architecture/index.rst
index 204604e8948..6fb2a1ebdfc 100644
--- a/docs/html/development/architecture/index.rst
+++ b/docs/html/development/architecture/index.rst
@@ -8,8 +8,9 @@ Architecture of pip's internals
     interested in helping out, please let us know in the `tracking issue`_.
 
 .. note::
-    Direct use of pip's internals is *not supported*.
-    For more details, see :ref:`Using pip from your program`.
+    Direct use of pip's internals is *not supported*, and these internals
+    can change at any time. For more details, see :ref:`Using pip from
+    your program`.
 
 
 .. toctree::