diff --git a/docs/source/index.rst b/docs/source/index.rst
index 9d4a5ee..cfe4944 100644
--- a/docs/source/index.rst
+++ b/docs/source/index.rst
@@ -6,12 +6,11 @@ Contents:
 .. toctree::
    :maxdepth: 2
 
+   manual/index.rst
+   reference/index.rst
    install/index.rst
    design/planning.rst
    design/milestones.rst
-   manual/index.rst
-   reference/index.rst
-
 
 
 Indices and tables
diff --git a/docs/source/manual/index.rst b/docs/source/manual/index.rst
index a40b467..ef89721 100644
--- a/docs/source/manual/index.rst
+++ b/docs/source/manual/index.rst
@@ -92,6 +92,10 @@ After committing, we can keep working in the same session, and do further commit
 Updatding and existing session
 ==============================
 
-At the moment it is not possible to update the session (if another artist updates one of the assets
-for example, we would like such asset to be updated in all the sessions using it).
+It is possible to update and existing session by running::
+
+    bam update
+
+Make sure you have committed your files before updating.
+