diff --git a/docs/actions.rst b/docs/actions.rst
index 144fc52f7..f9cefb83d 100644
--- a/docs/actions.rst
+++ b/docs/actions.rst
@@ -4,6 +4,7 @@ Mappable actions
 .. highlight:: conf
 
 The actions described below can be mapped to any key press or mouse action
-using the ``map`` and ``mouse_map`` directives in :file:`kitty.conf`.
+using the ``map`` and ``mouse_map`` directives in :file:`kitty.conf`. For
+configuration examples, see the default shortcut links for each action.
 
 .. include:: /generated/actions.rst
diff --git a/docs/kittens/hints.rst b/docs/kittens/hints.rst
index ff170ae30..61d436893 100644
--- a/docs/kittens/hints.rst
+++ b/docs/kittens/hints.rst
@@ -36,7 +36,7 @@ taken for different types of URLs <../open_actions>`.
 The hints kitten is very powerful to see more detailed help on its various
 options and modes of operation, see below. You can use these options to
 create mappings in :file:`kitty.conf` to select various different text
-snippets. See :sc:`insert_selected_path` for examples.
+snippets. See :sc:`insert_selected_path <insert_selected_path>` for examples.
 
 
 Completely customizing the matching and actions of the kitten
diff --git a/docs/overview.rst b/docs/overview.rst
index 00845afb2..a84808624 100644
--- a/docs/overview.rst
+++ b/docs/overview.rst
@@ -244,15 +244,15 @@ for example::
    map f1 launch --stdin-source=@screen_scrollback --stdin-add-formatting less +G -R
 
 Would open the scrollback buffer in a new :term:`window` when you press the :kbd:`F1`
-key. See :sc:`show_scrollback` for details.
+key. See :sc:`show_scrollback <show_scrollback>` for details.
 
 If you want to use it with an editor such as vim to get more powerful features,
 you can see tips for doing so, in
 `this thread <https://github.com/kovidgoyal/kitty/issues/719>`_.
 
 If you wish to store very large amounts of scrollback to view using the piping or
-:sc:`show_scrollback` features, you can use the :opt:`scrollback_pager_history_size`
-option.
+:sc:`show_scrollback <show_scrollback>` features, you can use the
+:opt:`scrollback_pager_history_size` option.
 
 
 Integration with shells
diff --git a/kitty/boss.py b/kitty/boss.py
index c91b7b9de..9dbf041cb 100755
--- a/kitty/boss.py
+++ b/kitty/boss.py
@@ -749,7 +749,7 @@ class Boss:
     @ac('misc', '''
         Clear the terminal
 
-        See :sc:`reset_terminal` for details. For example::
+        See :sc:`reset_terminal <reset_terminal>` for details. For example::
 
             # Reset the terminal
             map kitty_mod+f9 clear_terminal reset active
diff --git a/kitty/window.py b/kitty/window.py
index 769fd2475..40d59bbb1 100644
--- a/kitty/window.py
+++ b/kitty/window.py
@@ -569,7 +569,7 @@ class Window:
     @ac('misc', '''
         Send the specified text to the active window
 
-        For details, see :sc:`send_text`.
+        See :sc:`send_text <send_text>` for details.
         ''')
     def send_text(self, *args: str) -> bool:
         mode = keyboard_mode_name(self.screen)