diff --git a/content/community.txt b/content/community.txt
index 5feedbae8fddcd4086a3e38970222fcc73710d4f..a5d07c23a1a5698a83efed3c647715955ecf6857 100644
--- a/content/community.txt
+++ b/content/community.txt
@@ -84,7 +84,7 @@ It is best to base your work on the latest version of Kwant::
 
 Then you can modify the code, and build Kwant and the documentation as
 described in the `build instructions
-</docs/pre/install.html#building-and-installing-from-source>`_.
+</doc/1.0/pre/install.html#building-and-installing-from-source>`_.
 
 Some things to keep in mind:
 
diff --git a/content/index.txt b/content/index.txt
index 2c03cc60c8df581a9ae8420e7ba8f72a4e8d5c4f..30cd0e07cd87a95ff99c785ededc0d1d479905c8 100644
--- a/content/index.txt
+++ b/content/index.txt
@@ -17,21 +17,20 @@ systems and phenomena is within reach of one software package.
 Kwant does not use the traditional input files often found in scientific
 software packages. Instead, one writes simple Python programs (using the
 Python's simple and very expressive syntax) to define the system and calculate
-its quantum properties (conductance, density of states, etc). Kwant was
-designed to be easy to use, and accessible for people without expertise in
-numerics. It also comes with a detailed hand-on `tutorial </docs/tutorial/>`_
-and the Kwant `paper </paper>`_, which describes the guiding principles
-underlying its design.
+its quantum properties (conductance, density of states, etc). This workflow is
+summarized as follows:
 
-Kwant is provided to the physics community as an open source free software (we
-merely ask you to quote Kwant article in scientific publications where Kwant
-was used). Below a few research applications of Kwant are shown.
+.. image:: kwant_workflow.png
 
-Chaotic billiard
-----------------
+Kwant was designed to be easy to use: for example the program that generates
+the right panel of the image above is only 42 lines long. It is also accessible
+for people without expertise in numerics. To aid that, it is provided along
+with a detailed hand-on `tutorial </doc/1.0/tutorial/>`_ and the Kwant `paper
+</paper>`_, which describes the guiding principles underlying its design.
 
-This figure shows the local density of state of a quantum billiard with a stadium shape. 
-The entire code to perform this calculation (including making the figure) is reproduced below and is, as one can see, rather small.
+Kwant is provided to the physics community as an open source free software (we
+merely ask you to cite Kwant article in scientific publications using
+Kwant). Below a few research applications of Kwant are shown.
 
 
 3-d systems
@@ -41,8 +40,9 @@ The entire code to perform this calculation (including making the figure) is rep
 
    .. image:: 3d_systems.png
 
-In this example, one can see a quantum wire (gray) to which is attached a superconducting electrode (blue).
-This device has been built in order to give rise to a Majorana bound states close to the superconducting-normal interface.
+In this example, one can see a quantum wire (gray) to which is attached a
+superconducting electrode (blue).  This device has been built in order to give
+rise to a Majorana bound states close to the superconducting-normal interface.
 The latter can be seen in the spectrum of the device (REF).
 
 
@@ -53,12 +53,16 @@ Flying qubit
 
    .. image:: flying-qubit.png
 
-This example shows some numerical simulations (left) and experimental results (right) for a flying Qubit sample made in a
-GaAs/GaAlAs heterostrucutre. See Yamamoto et al, Nature Nanotechnology 7, 247 (2012) for details about this experiment. 
-(Simulations: T. Bautze et al. to be submitted to Phys. Rev. B). In this example, particular attention was paid to designing a realistic
-model for the confining potential seen by the electrons so that rather subtle aspects of the experiments could be reproduce. Such type of
-"numerical experiments" can not only be used to interpret the experimental data but also as an aid in designing the sample geometry or in the choice of
-materials. 
+This example shows some numerical simulations (left) and experimental results
+(right) for a flying Qubit sample made in a GaAs/GaAlAs heterostrucutre. See
+Yamamoto et al, Nature Nanotechnology 7, 247 (2012) for details about this
+experiment.  (Simulations: T. Bautze et al. to be submitted to
+Phys. Rev. B). In this example, particular attention was paid to designing a
+realistic model for the confining potential seen by the electrons so that
+rather subtle aspects of the experiments could be reproduce. Such type of
+"numerical experiments" can not only be used to interpret the experimental data
+but also as an aid in designing the sample geometry or in the choice of
+materials.