diff --git a/docs/source/install/kernel_install.rst b/docs/source/install/kernel_install.rst
index 9e04590..b4614e6 100644
--- a/docs/source/install/kernel_install.rst
+++ b/docs/source/install/kernel_install.rst
@@ -14,13 +14,10 @@ environments) as a kernel for Jupyter by following these steps:
* See `ipython kernel install --help` for the list of installation options like
naming the kernel, or non default install location.
* The IPython kernel for Jupyter is provided by the `ipykernel` python package,
- see there if you need more flexibility for installation.
+ see `ipykernel documentation `_ if you
+ need more flexibility for installation.
-The last command installs a :ref:`kernel spec ` file
-for the current python installation. Kernel spec files are JSON files, which
-can be viewed and changed with a normal text editor.
-
For example:
.. sourcecode:: bash
@@ -35,6 +32,11 @@ or
~/envs/kernel-environment/python -m ipykernel install --user
+The last command installs a :ref:`kernel spec ` file
+for the current python installation. Kernel spec files are JSON files, which
+can be viewed and changed with a normal text editor.
+
+
.. note ::
The command `ipython kernelspec` is deprecated and will be removed in future versions.