diff --git a/docs/build.rst b/docs/build.rst
index ea8d8be81..9c80a16e8 100644
--- a/docs/build.rst
+++ b/docs/build.rst
@@ -23,6 +23,10 @@ following dependencies are installed first.
    should use a version of the source that matches the binary version as closely
    as possible, since the two are tightly coupled.
 
+   You may need to unset the :envvar:`KITTY_PREWARM_SOCKET` environment variable,
+   otherwise your modified code will not be executed, when running some of the
+   ``kitty +`` and ``kitty @`` commands.
+
 
 Dependencies
 ----------------
diff --git a/docs/glossary.rst b/docs/glossary.rst
index 9a32b013a..8a8e09cf6 100644
--- a/docs/glossary.rst
+++ b/docs/glossary.rst
@@ -145,7 +145,8 @@ Variables that kitty sets when running child programs
 .. envvar:: KITTY_PREWARM_SOCKET
 
    Path to a UNIX domain socket used to avoid Python interpreter startup
-   latency when running kittens, or remote control or using kitty +launch or kitty +runpy.
+   latency when running kittens, or remote control or using ``kitty +launch`` or
+   ``kitty +runpy``.
 
 .. envvar:: KITTY_PREWARM_SOCKET_REAL_TTY