docs: add example for calling rollback from python code

Thanks to Alfred Nutile for the suggestion

1 files changed, 6 insertions, 0 deletions

diff --git a/doc/index.rst b/doc/index.rst
index 2d27ebc..3c3515a 100644
--- a/doc/index.rst
+++ b/doc/index.rst
@@ -334,9 +334,15 @@ The following example shows how to apply migrations from inside python code:
 
     backend = get_backend('postgres://myuser@localhost/mydatabase')
     migrations = read_migrations('path/to/migrations')
+
     with backend.lock():
+
+        # Apply any outstanding migrations
         backend.apply_migrations(backend.to_apply(migrations))
 
+        # Rollback all migrations
+        backend.rollback_migrations(backend.to_rollback(migrations))
+
 .. :vim:sw=4:et
 
 .. toctree::