structurating some documentation files

docs/index.rst

@@ -24,24 +24,28 @@ First steps
 ===========
 
     * **What is Lettuce, and what it does:**
-      :ref:`Overview <intro-overview>` |
-      :ref:`Installation <intro-install>`
+
+      * :ref:`Overview <intro-overview>`
+      * :ref:`Installation <intro-install>`
 
     * **Tutorial:**
-      :ref:`Simple features <tutorial-simple>` |
-      :ref:`Steps with tables <tutorial-tables>` |
-      :ref:`Scenario Outlines <tutorial-scenario-outlines>` |
-      :ref:`Taking actions before and after tests <tutorial-hooks>`
+
+      * :ref:`Simple features <tutorial-simple>`
+      * :ref:`Steps with tables <tutorial-tables>`
+      * :ref:`Scenario Outlines <tutorial-scenario-outlines>`
+      * :ref:`Taking actions before and after tests <tutorial-hooks>`
 
     * **Reference and concepts:**
-      :ref:`Features <reference-features>` |
-      :ref:`Scenarios <reference-scenarios>` |
-      :ref:`Steps <reference-steps>` |
-      :ref:`Hooks <reference-hooks>` |
-      :ref:`World <reference-world>` |
-      :ref:`Language support <reference-languages>`
+
+      * :ref:`Features <reference-features>`
+      * :ref:`Scenarios <reference-scenarios>`
+      * :ref:`Steps <reference-steps>`
+      * :ref:`Hooks <reference-hooks>`
+      * :ref:`World <reference-world>`
+      * :ref:`Language support <reference-languages>`
 
 Recipes
 =======
+
     * :ref:`Browser testing with webdriver <recipes-webdriver>`
     * :ref:`Best assertions with nose <recipes-nose>`

docs/tutorial/hooks.rst

-.. _hooks:
+.. _tutorial-hooks:
 
 =====
 Hooks

docs/tutorial/scenario-outlines.rst

-.. _scenario-outlines:
+.. _tutorial-scenario-outlines:
 
 =================
 Scenario Outlines

docs/tutorial/simple.rst

-.. _simple:
+.. _tutorial-simple:
 
 ======
 Simple

docs/tutorial/tables.rst

-.. _tables:
+.. _tutorial-tables:
 
 ======
 Tables