diff --git a/doc/setup.rst b/doc/setup.rst
index 7e197999b1..4508b0de34 100644
--- a/doc/setup.rst
+++ b/doc/setup.rst
@@ -532,8 +532,12 @@ Upgrading from an older version
 .. warning::
 
     **Never** extract the new version over an existing installation of
-    phpMyAdmin. This way you will leave old no longer working code in the
-    directory, what can have severe security implications.
+    phpMyAdmin, always first remove the old files keeping just the
+    configuration.
+    
+    This way you will not leave old no longer working code in the directory,
+    what can have severe security implications or can cause various breakages.
+
 
 Simply copy :file:`config.inc.php` from your previous installation into
 the newly unpacked one. Configuration files from old versions may