diff --git a/doc/blender-scons.txt b/doc/blender-scons.txt
index bc0237494dc..57f9f1c5ab6 100644
--- a/doc/blender-scons.txt
+++ b/doc/blender-scons.txt
@@ -94,6 +94,11 @@ $Id$
     (unless you have overridden any of them in your
     $BLENDERHOME/user-config.py).
 
+    NOTE: The best way to avoid confusion is the
+    copy $BLENDERHOME/config/(platform)-config.py to
+    $BLENDERHOME/user-config.py. You should NEVER have to modify
+    $BLENDERHOME/config/(platform)-config.py
+
     Configuring the output
     ----------------------