diff --git a/docs/changelog.rst b/docs/changelog.rst
index a1bf08eb5..48f738663 100644
--- a/docs/changelog.rst
+++ b/docs/changelog.rst
@@ -56,6 +56,9 @@ To update |kitty|, :doc:`follow the instructions <binary>`.
 - broadcast kitten: Show a "fake" cursor in all windows being broadcast too
   (:iss:`4225`)
 
+- Allow defining aliases for more general actions, not just kittens
+  (:pull:`4260`)
+
 - Fix a regression that caused :option:`kitty --title` to not work when
   opening new OS windows using :option:`kitty --single-instance` (:iss:`3893`)
 
@@ -210,9 +213,6 @@ To update |kitty|, :doc:`follow the instructions <binary>`.
   --program` option work when using the ``self``
   :option:`kitty +kitten hints --linenum-action` (:iss:`3931`)
 
-- Allow defining aliases for more general actions, not just kittens
-  (:pull:`4260`)
-
 
 0.22.2 [2021-08-02]
 ----------------------
diff --git a/docs/kittens/hints.rst b/docs/kittens/hints.rst
index cda267b05..ff170ae30 100644
--- a/docs/kittens/hints.rst
+++ b/docs/kittens/hints.rst
@@ -93,7 +93,8 @@ look it up in the Google dictionary.
 .. note::
 
     To avoid having to specify the same command line options on every invocation,
-    you can use the :opt:`kitten_alias` option in :file:`kitty.conf`, creating aliases
+    you can use the :opt:`action_alias` option in :file:`kitty.conf`, creating aliases
     that have common sets of options. For example::
 
-        kitten_alias myhints hints --alphabet qfjdkslaureitywovmcxzpq1234567890
+        action_alias myhints kitten hints --alphabet qfjdkslaureitywovmcxzpq1234567890
+        map f1 myhints --customize-processing custom-hints.py