From: Christopher Allan Webber <cwebber@dustycloud.org>
Date: Thu, 20 Jun 2013 17:08:20 +0000 (-0500)
Subject: What is models_v0.py?  An explaination!
X-Git-Url: https://vcs.fsf.org/?a=commitdiff_plain;h=98454be7e924b2341b96b1317dfbf8a32fbca607;p=mediagoblin.git

What is models_v0.py?  An explaination!

This commit sponsored by Alex Hannan-Joyner.  Thanks!
---

diff --git a/mediagoblin/db/models_v0.py b/mediagoblin/db/models_v0.py
index ec51a1f5..bdedec2e 100644
--- a/mediagoblin/db/models_v0.py
+++ b/mediagoblin/db/models_v0.py
@@ -18,6 +18,29 @@
 TODO: indexes on foreignkeys, where useful.
 """
 
+###########################################################################
+# WHAT IS THIS FILE?
+# ------------------
+#
+# Upon occasion, someone runs into this file and wonders why we have
+# both a models.py and a models_v0.py.
+#
+# The short of it is: you can ignore this file.
+#
+# The long version is, in two parts:
+#
+#  - We used to use MongoDB, then we switched to SQL and SQLAlchemy.
+#    We needed to convert peoples' databases; the script we had would
+#    switch them to the first version right after Mongo, convert over
+#    all their tables, then run any migrations that were added after.
+#
+#  - That script is now removed, but there is some discussion of
+#    writing a test that would set us at the first SQL migration and
+#    run everything after.  If we wrote that, this file would still be
+#    useful.  But for now, it's legacy!
+#
+###########################################################################
+
 
 import datetime
 import sys