Fixed #22071 -- Added a warning regarding override_settings and aliasing.

Thanks EvilDMP for the suggestion.

1 files changed, 4 insertions, 0 deletions

diff --git a/docs/topics/testing/tools.txt b/docs/topics/testing/tools.txt
index a93ef39835..14ba1b2cd2 100644
--- a/docs/topics/testing/tools.txt
+++ b/docs/topics/testing/tools.txt
@@ -1181,6 +1181,10 @@ The decorator can also be applied to test case classes::
     the session backend in a test that uses cached sessions and overrides
     :setting:`CACHES`.
 
+    Finally, avoid aliasing your settings as module-level constants as
+    ``override_settings()`` won't work on such values since they are
+    only evaluated the first time the module is imported.
+
 You can also simulate the absence of a setting by deleting it after settings
 have been overridden, like this::