diff --git a/docs/changelog.rst b/docs/changelog.rst
index 03dec49f7..7612a8556 100644
--- a/docs/changelog.rst
+++ b/docs/changelog.rst
@@ -7,11 +7,11 @@ To update |kitty|, :doc:`follow the instructions <binary>`.
 0.23.2 [future]
 ----------------------
 
-- A new option :option:`tab_bar_align` to draw the tab bar centered or right
+- A new option :opt:`tab_bar_align` to draw the tab bar centered or right
   aligned (:iss:`3946`)
 
 - Allow the user to supply a custom Python function to draw tab bar. See
-  :option:`tab_bar_style`
+  :opt:`tab_bar_style`
 
 - Fix a regression that caused :option:`kitty --title` to not work when
   opening new OS windows using :option:`kitty --single-instance` (:iss:`3893`)
diff --git a/docs/glossary.rst b/docs/glossary.rst
index 5cd7a5c5b..3da3f5a98 100644
--- a/docs/glossary.rst
+++ b/docs/glossary.rst
@@ -73,9 +73,10 @@ Variables that influence kitty behavior
 
 .. envvar:: KITTY_WAYLAND_DETECT_MODIFIERS
 
-   When set to a non-empty value, kitty attempts to autodiscover XKB
-   modifiers under Wayland. It is possible for the autodiscovery to
-   fail; the default Wayland XKB mappings are used in this case.
+   When set to a non-empty value, kitty attempts to autodiscover XKB modifiers
+   under Wayland. This is useful if using non-standard modifers like hyper. It
+   is possible for the autodiscovery to fail; the default Wayland XKB mappings
+   are used in this case. See :pull:`3943` for details.
 
 
 Variables that kitty sets when running child programs