diff --git a/docs/faq.rst b/docs/faq.rst
index f976e08d8..fcff0e8a0 100644
--- a/docs/faq.rst
+++ b/docs/faq.rst
@@ -54,6 +54,8 @@ type it each time::
 
     alias ssh="kitty +kitten ssh"
 
+Remember to also setup :ref:`completion`.
+
 If for some reason that does not work (typically because the server is using a
 non POSIX compliant shell as ``/bin/sh``), you can try using it with ``python``
 instead::
diff --git a/docs/index.rst b/docs/index.rst
index ba682c9df..27c2db107 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -345,8 +345,6 @@ Frequently Asked Questions
 
 The list of Frequently Asked Questions (*FAQ*) is :doc:`available here <faq>`.
 
-.. _completion:
-
 
 Cool integrations for kitty with other CLI tools
 --------------------------------------------------
@@ -356,6 +354,8 @@ kitty provides extremely powerful interfaces such as :doc:`remote-control` and
 that allow it to be integrated with other tools seamlessly. For a list of such
 user created integrations, see: :doc:`integrations`.
 
+.. _completion:
+
 Completion for kitty
 ---------------------------------