From 14ff8828c844ead5b511ec6f12653795efe36d9c Mon Sep 17 00:00:00 2001
From: Thierry Parmentelat <thierry.parmentelat@inria.fr>
Date: Sat, 9 Nov 2013 10:25:45 +0100
Subject: [PATCH] start a readme on this move

---
 docs/dbsession.readme | 13 +++++++++++++
 1 file changed, 13 insertions(+)
 create mode 100644 docs/dbsession.readme

diff --git a/docs/dbsession.readme b/docs/dbsession.readme
new file mode 100644
index 00000000..db453422
--- /dev/null
+++ b/docs/dbsession.readme
@@ -0,0 +1,13 @@
+As of Nov. 2013, when moving from 3.0 to 3.2
+--------------------------------------------
+
+* driver-creation
+. expect an api instead of a config (and api.config is set)
+
+* managers
+. cannot access their driver from self, but from the context (api is passed to methods)
+
+* dbsession
+. use api.dbsession() whenever possible
+. it's fair to have importers and sfaadmin use the global session (there won't be instances of api in their case)
+. there is one or 2 exceptions where dbsession is retrieved from an sqlalchemy object but this is deemed poor practice, please DO NOT do this as far as possible
-- 
2.47.0