diff --git a/core/core-keybinds.el b/core/core-keybinds.el
index acbfe37eb..082d7bb1d 100644
--- a/core/core-keybinds.el
+++ b/core/core-keybinds.el
@@ -5,17 +5,26 @@
 ;; never loaded, then evil bindings set with `map!' will be ignored.
 
 (defvar doom-leader-key "SPC"
-  "The leader prefix key for Evil users.")
+  "The leader prefix key for Evil users.
+
+This needs to be changed from $DOOMDIR/init.el.")
 
 (defvar doom-leader-alt-key "M-SPC"
   "An alternative leader prefix key, used for Insert and Emacs states, and for
-non-evil users.")
+non-evil users.
+
+This needs to be changed from $DOOMDIR/init.el.")
 
 (defvar doom-localleader-key "SPC m"
-  "The localleader prefix key, for major-mode specific commands.")
+  "The localleader prefix key, for major-mode specific commands.
+
+This needs to be changed from $DOOMDIR/init.el.")
 
 (defvar doom-localleader-alt-key "M-SPC m"
-  "The localleader prefix key, for major-mode specific commands.")
+  "The localleader prefix key, for major-mode specific commands. Used for Insert
+and Emacs states, and for non-evil users.
+
+This needs to be changed from $DOOMDIR/init.el.")
 
 (defvar doom-leader-map (make-sparse-keymap)
   "An overriding keymap for <leader> keys.")