first sphinx docstrings

migrate/__init__.py

@@ -0,0 +1,14 @@
+"""
+SQLAlchemy Migrate
+------------------
+
+SQLAlchemy migrate provides two APIs :mod:`migrate.versioning` for database
+schema version and repository management and :mod:`migrate.changeset` that
+allows to define database schema changes using Python.
+
+.. automodule:: migrate.changeset
+   :members:
+
+.. automodule:: migrate.versioning
+   :members:
+"""

migrate/changeset/__init__.py

@@ -1,3 +1,23 @@
+"""
+Module :mod:`migrate.changeset`
+===============================
+
+This module extends SQLAlchemy and provides additional DDL [#]_ support.
+
+.. [#] SQL Data Definition Language
+
+.. automodule:: migrate.changeset.ansisql
+   :members:
+.. automodule:: migrate.changeset.constraint
+   :members:
+.. automodule:: migrate.changeset.databases
+   :synopsis: database specific changeset code
+   :members:
+.. automodule:: migrate.changeset.exceptions
+   :members:
+.. automodule:: migrate.changeset.schema
+   :members:
+"""
 from migrate.changeset.schema import *
 from migrate.changeset.constraint import *
 

migrate/changeset/ansisql.py

@@ -1,4 +1,8 @@
-"""Extensions to SQLAlchemy for altering existing tables.
+"""
+Module :mod:`migrate.changeset.ansisql`
+---------------------------------------
+
+Extensions to SQLAlchemy for altering existing tables.
 At the moment, this isn't so much based off of ANSI as much as things that just
 happen to work with multiple databases.
 """

migrate/versioning/__init__.py

@@ -0,0 +1,7 @@
+"""
+Module migrate.versioning
+-------------------------
+
+This package provides functionality to create and manage repositories of
+database schema changesets and to apply these changesets to databases.
+"""