update installation instructions

content/install.rst

@@ -18,8 +18,8 @@ language. If you are using a GNU/Linux operating system this should already be
 installed on your computer.
 
 If you are using Mac OS X or Microsoft Windows you will need to install a
-Python distribution yourself. Details of how to do this are in the "Quick
-Install" section of the corresponding platform.
+Python distribution yourself. Details of how to do this are in the
+installation instructions of the corresponding platform.
 
 **Kwant version 1.2 and newer requires at least Python 3.4**.
 
@@ -140,12 +140,12 @@ The fingerprint of the key is 5229 9057 FAD7 9965 3C4F 088A C3F1 47F5 980F
 
 Mac OS X
 ========
-Pre-built packages for Max OS X exist for the ``conda`` package
-manager, which is a part of the `Anaconda` Python distribution.
+`Pre-built packages <#conda>`_ for Max OS X exist for the ``conda`` package
+manager, which is a part of the ``Anaconda`` Python distribution.
 Using ``conda`` is the recommended way to install Kwant on Mac OS X.
 
 If you do not want to use the ``conda`` packages, you can always install Kwant
-using `pip`_. Or by directly building `from source`_.
+using `pip`_. Or by directly `building from source`_.
 
 We previously maintained Homebrew and Macports packages for Kwant, but due to
 effort required to keep them up to date we have dropped support for these
@@ -222,9 +222,10 @@ dependencies so that you can use the `IPython notebook <http://ipython.org/noteb
 
 
 ``conda``
----------
-``conda`` is the package manager for the Anaconda Python distribution, and
-Kwant currently has packages for GNU/Linux and Mac OS X platforms.
+=========
+``conda`` is the package manager for the Anaconda Python distribution.
+
+Kwant currently has ``conda`` packages for GNU/Linux and Mac OS X platforms.
 
 1. Download the Python 3.6 verision of `Anaconda <https://www.continuum.io/downloads>`_ for
    your platform and install it.
@@ -285,11 +286,12 @@ required by Kwant. Kwant has several non-Python dependencies:
 + Lapack
 + `MUMPS <http://graal.ens-lyon.fr/MUMPS/>`_.
 
-If you using a GNU/Linux system then your distribution probably has packages for
-these libraries; you will need to install the `-dev` versions of the packages.
+If you using a GNU/Linux system then your distribution probably has packages
+for these libraries; you will need to install the `-dev` or `-devel` versions
+of the packages.
 
 As an example, on a Debian or Ubuntu system, the following
-command will install the non-Python prerequisites of Kwant::
+command will install the non-Python dependencies of Kwant::
 
     sudo apt-get install build-essential gfortran libopenblas-dev liblapack-dev libmumps-scotch-dev
 
@@ -312,7 +314,7 @@ installing kwant::
 
 
 Building from source
---------------------
+====================
 If no packages are available for the system you use, or if you would like to
 build Kwant from source for another reason (expert users may want to customize
 Kwant to use certain optimized versions of libraries), please consult the