diff --git a/docs/index.rst b/docs/index.rst
index 4b96ade..8d44143 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -120,7 +120,7 @@ Dialect support
 .. [#4] Changing nullable is not supported
 
 
-Documentation
+User guide
 -------------
 
 SQLAlchemy Migrate is split into two parts, database schema versioning (:mod:`migrate.versioning`) and
diff --git a/docs/tools.rst b/docs/tools.rst
index e67feea..9c2a920 100644
--- a/docs/tools.rst
+++ b/docs/tools.rst
@@ -1,11 +1,9 @@
-SQLAlchemy migrate tools
-========================
-
-The most commonly used tool is the :ref:`migrate <command-line-usage>`.
+Repository migration (0.4.5 -> 0.5.4)
+================================================
 
 .. index:: repository migration
 
-There is a second tool :command:`migrate_repository.py` that may be
+:command:`migrate_repository.py` should be
 used to migrate your repository from a version before 0.4.5 of
 SQLAlchemy migrate to the current version.
 
diff --git a/docs/versioning.rst b/docs/versioning.rst
index a361306..e49dd32 100644
--- a/docs/versioning.rst
+++ b/docs/versioning.rst
@@ -13,7 +13,7 @@ Purpose of this package is frontend for migrations. It provides commands
 to manage migrate repository and database selection aswell as script versioning.
 
 
-Project Setup
+Project setup
 =============
 
 .. _create_change_repository: