diff --git a/README.org b/README.org
index 74baeb27811..5db07c1b6fd 100644
--- a/README.org
+++ b/README.org
@@ -299,6 +299,8 @@ available options.
 ;; (setq which-key-sort-order 'which-key-key-order-alpha)
 ;; same as default, except all prefix keys are grouped together at the end
 ;; (setq which-key-sort-order 'which-key-prefix-then-key-order)
+;; same as default, except all keys from local maps shown first
+;; (setq which-key-sort-order 'which-key-prefix-then-key-order)
 ;; sort based on the key description ignoring case
 ;; (setq which-key-sort-order 'which-key-description-order)
 #+END_SRC
diff --git a/which-key.el b/which-key.el
index d221c6fdcd2..2cdf1cb94bb 100644
--- a/which-key.el
+++ b/which-key.el
@@ -245,8 +245,10 @@ a percentage out of the frame's height."
 are
 
 1. `which-key-key-order': by key (default)
-2. `which-key-description-order': by description
-3. `which-key-prefix-then-key-order': prefix (no prefix first) then key
+2. `which-key-key-order-alpha': by key using alphabetical order
+3. `which-key-description-order': by description
+4. `which-key-prefix-then-key-order': prefix (no prefix first) then key
+5. `which-key-local-then-key-order': local binding then key
 
 See the README and the docstrings for those functions for more
 information."