import changeset into sql models

[mediagoblin.git] / mediagoblin / db / __init__.py

diff --git a/mediagoblin/db/__init__.py b/mediagoblin/db/__init__.py
index f0116083f7ce818d58268e67acb92d8ec875d1d6..27e8a90f28f1364a822502407f429501537d00a1 100644 (file)
--- a/mediagoblin/db/__init__.py
+++ b/mediagoblin/db/__init__.py
@@ -1,5 +1,5 @@
 # GNU MediaGoblin -- federated, autonomous media hosting
-# Copyright (C) 2011 Free Software Foundation, Inc
+# Copyright (C) 2011 MediaGoblin contributors.  See AUTHORS.
 #
 # This program is free software: you can redistribute it and/or modify
 # it under the terms of the GNU Affero General Public License as published by
@@ -18,6 +18,18 @@
 Database Abstraction/Wrapper Layer
 ==================================
 
+  **NOTE from Chris Webber:** I asked Elrond to explain why he put
+  ASCENDING and DESCENDING in db/util.py when we could just import from
+  pymongo.  Read beow for why, but note that nobody is actually doing
+  this and there's no proof that we'll ever support more than
+  MongoDB... it would be a huge amount of work to do so.
+
+  If you really want to prove that possible, jump on IRC and talk to
+  us about making such a branch.  In the meanwhile, it doesn't hurt to
+  have things as they are... if it ever makes it hard for us to
+  actually do things, we might revisit or remove this.  But for more
+  information, read below.
+
 This submodule is for most of the db specific stuff.
 
 There are two main ideas here: