take comments into account

docs/source/install/kernel_install.rst

@@ -14,13 +14,10 b' 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 <http://ipykernel.readthedocs.org/>`_ if you
+  need more flexibility for installation.
 
 
-The last command installs a :ref:`kernel spec <jupyterclient:kernelspecs>` 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 b' or'
 
     ~/envs/kernel-environment/python -m ipykernel install --user
 
+The last command installs a :ref:`kernel spec <jupyterclient:kernelspecs>` 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.