diff --git a/doc/source/custom-ansible-playbooks.rst b/doc/source/custom-ansible-playbooks.rst
index bb1e25fce..394904c1f 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 3be69426e..ba92554c2 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
 ========================