diff --git a/docs/source/install/index.rst b/docs/source/install/index.rst
index 78c8536..3793fae 100644
--- a/docs/source/install/index.rst
+++ b/docs/source/install/index.rst
@@ -14,8 +14,8 @@ Installation
 
 
 
-This sections will guide you through `installing IPython itself <install>`_, and
-installing `kernels for Jupyter <kernel_install>`_ if you wish to work with
+This sections will guide you through :ref:`installing IPython itself <install>`, and
+installing :ref:`kernels for Jupyter <kernel_install>` if you wish to work with
 multiple version of Python, or multiple environments.
 
 
diff --git a/docs/source/install/install.rst b/docs/source/install/install.rst
index 32ab774..eb6db45 100644
--- a/docs/source/install/install.rst
+++ b/docs/source/install/install.rst
@@ -1,3 +1,5 @@
+.. _install:
+
 Installing IPython
 ==================