]> git.ipfire.org Git - thirdparty/sqlalchemy/alembic.git/commitdiff
more edits
authorMike Bayer <mike_mp@zzzcomputing.com>
Sun, 8 Jul 2012 22:45:10 +0000 (18:45 -0400)
committerMike Bayer <mike_mp@zzzcomputing.com>
Sun, 8 Jul 2012 22:45:10 +0000 (18:45 -0400)
README.rst

index 34c72b8b33d93c6ab096c66a0b6f4cdaf77e1f6e..b3ff87a767197303a720e31e0840cc00da46269e 100644 (file)
@@ -61,14 +61,17 @@ The goals of Alembic are:
   application. The DDL constructs build upon SQLAlchemy's own DDLElement base
   and can be used standalone by any application or script.
 * Don't break our necks over SQLite's inability to ALTER things.   SQLite
-  has almost no support for table or column alteration.   Alembic's design
-  is kept simple by not contorting it's core API around these limitations.
-  Alembic's architecture can support SQLite's workarounds however, and
+  has almost no support for table or column alteration, and this is likely
+  intentional.   Alembic's design
+  is kept simple by not contorting it's core API around these limitations,
+  understanding that SQLite is simply not intended to support schema
+  changes.   While Alembic's architecture can support SQLite's workarounds, and
   we will support these features provided someone takes the initiative
-  to implement and test.  However, until the SQLite developers decide
-  to implment full support for ALTER, it's still vastly preferable
-  to use Alembic, or any migrations tool, with a database that supports
-  ALTER fully.
+  to implement and test, until the SQLite developers decide
+  to provide a fully working version of ALTER, it's still vastly preferable
+  to use Alembic, or any migrations tool, with databases that
+  are designed to work under the assumption of in-place schema migrations
+  taking place.
 
 Documentation and status of Alembic is at http://readthedocs.org/docs/alembic/.