diff --git a/doc/source/custom-ansible-playbooks.rst b/doc/source/custom-ansible-playbooks.rst
index bb1e25fce29e4360a9b5a557fced2d4cc46cdafd..394904c1f77e4346a4d90396431baef11bdb05e9 100644
--- a/doc/source/custom-ansible-playbooks.rst
+++ b/doc/source/custom-ansible-playbooks.rst
@@ -66,6 +66,12 @@ plugins:
 
 These symlinks can even be committed to the kayobe-config Git repository.
 
+.. note::
+
+   These symlinks rely on having a kayobe source checkout at the same level as
+   the kayobe-config repository checkout, as described in
+   :ref:`installation-source`.
+
 Ansible Galaxy
 --------------
 
diff --git a/doc/source/installation.rst b/doc/source/installation.rst
index 3be69426e97a8129281bacd7b593b328ac3fb80d..ba92554c2133cc3577f1da2119eab9bb96704989 100644
--- a/doc/source/installation.rst
+++ b/doc/source/installation.rst
@@ -109,6 +109,8 @@ Finally, deactivate the virtualenv::
 
     (kayobe) $ deactivate
 
+.. _installation-source:
+
 Installation from source
 ========================