diff --git a/config/config.sample.php b/config/config.sample.php
index 65f473584d0..791ffa3df90 100644
--- a/config/config.sample.php
+++ b/config/config.sample.php
@@ -53,6 +53,9 @@ $CONFIG = array(
  * all your passwords. This example is for documentation only,
  * and you should never use it.
  *
+ * @deprecated This salt is deprecated and only used for legacy-compatibility, developers
+ * should *NOT* use this value for anything nowadays.
+ * 
  *'passwordsalt' => 'd3c944a9af095aa08f',
  */
 'passwordsalt' => '',