Updated documentation for the migrations.

2 files changed, 25 insertions, 0 deletions

diff --git a/README.rst b/README.rst
index b41b64f4..831297e5 100644
--- a/README.rst
+++ b/README.rst
@@ -184,6 +184,7 @@ Documentation
 =============
 
 * `web services <documentation/web-services.rst>`_;
+* `migrations <documentation/migrations.rst>`_
 
 
 Donation
diff --git a/documentation/migrations.rst b/documentation/migrations.rst
index e69de29b..174c1132 100644
--- a/documentation/migrations.rst
+++ b/documentation/migrations.rst
@@ -0,0 +1,24 @@
+Migrations
+==========
+
+Migrations of the database are managed
+with the database migrations tool
+`Alembic <https://bitbucket.org/zzzeek/alembic>`_.
+
+The Flask extensions `Flask-Script <https://github.com/smurfix/flask-script>`_
+and `Flask-Migrate <https://github.com/miguelgrinberg/flask-migrate/>_`
+are used to ease remote migrations.
+
+Local migrations
+----------------
+
+.. code:: bash
+
+    $ python manage.py db upgrade
+
+Remote migrations
+-----------------
+
+.. code:: bash
+
+    $ heroku run python manage.py db upgrade