Some docstrings

1 files changed, 13 insertions, 0 deletions

diff --git a/mediagoblin/db/open.py b/mediagoblin/db/open.py
index 9922cc10..81cd019c 100644
--- a/mediagoblin/db/open.py
+++ b/mediagoblin/db/open.py
@@ -59,12 +59,25 @@ else:
     from sqlalchemy.orm import sessionmaker
 
     class DatabaseManager(object):
+        """
+        Manage database connections.
+
+        The main method here is session_scope which can be used with a
+        "with" statement to get a session that is properly torn down
+        by the end of execution.
+        """
         def __init__(self, engine):
             self.engine = engine
             self.Session = sessionmaker(bind=engine)
 
         @contextmanager
         def session_scope(self):
+            """
+            This is a context manager, use like::
+
+              with dbmanager.session_scope() as request.db:
+                  some_view(request)
+            """
             session = self.Session()
 
             #####################################