From ccdb58c2e18e6aed4fad2c0438a0ede21a429b40 Mon Sep 17 00:00:00 2001
From: Vineet Kumar <vineetkumar17112004@gmail.com>
Date: Tue, 20 Jan 2026 22:33:11 +0530
Subject: [PATCH] Document caution regarding use of importlib.reload in
 production code

---
 Doc/faq/programming.rst | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/Doc/faq/programming.rst b/Doc/faq/programming.rst
index 6f9dfa8616ed44..8bd14e3465ae32 100644
--- a/Doc/faq/programming.rst
+++ b/Doc/faq/programming.rst
@@ -2218,6 +2218,10 @@ changed module, do this::
    import modname
    importlib.reload(modname)
 
+Note that :func:`importlib.reload` was originally designed for use in
+development and debugging, not for use in production code.  Reloading modules
+in a running program is tricky and error-prone.
+
 Warning: this technique is not 100% fool-proof.  In particular, modules
 containing statements like ::