Repository :
http://git.fedorahosted.org/cgit/fedocal.git
On branch : master
---------------------------------------------------------------
commit b8fa05929cdc5036ae8976f546b64fd4b37c12d6
Author: Pierre-Yves Chibon <pingou(a)pingoured.fr>
Date: Wed Nov 14 16:51:57 2012 +0100
Improve a little bit the documentation on database change using alembic
With this change we don't need to go to the alembic website for basic
database change or to find the right command to make a database
revision.
---------------------------------------------------------------
doc/development.rst | 15 +++++++++++++--
1 files changed, 13 insertions(+), 2 deletions(-)
diff --git a/doc/development.rst b/doc/development.rst
index 6c33ee6..f87f37f 100644
--- a/doc/development.rst
+++ b/doc/development.rst
@@ -135,5 +135,16 @@ handled via `alembic <
http://pypi.python.org/pypi/alembic>`_.
See the `alembic tutorial
-<http://alembic.readthedocs.org/en/latest/tutorial.html>`_ for more information
-on how to make a revision to the database schema.
+<http://alembic.readthedocs.org/en/latest/tutorial.html>`_ for complete
+information on how to make a revision to the database schema.
+
+
+The basic idea is to create a revision using (in the top folder):
+
+::
+ alembic revision -m "<description of the change>"
+
+Then edit the file generated in alembic/versions/ to add the correct command
+for upgrade and downgrade (for example: ``op.add_column``, ``op.drop_column``,
+``op.create_table``, ``op.drop_table``).
+