docs/dbsession.readme

   1 As of Nov. 2013, when moving from 3.0 to 3.2
   2 --------------------------------------------
   3
   4 * driver-creation
   5 . expect an api instead of a config (and api.config is set)
   6
   7 * managers
   8 . cannot access their driver from self, but from the context (api is passed to methods)
   9
  10 * dbsession
  11 . use api.dbsession() whenever possible
  12 . it's fair to have importers and sfaadmin use the global session (there won't be instances of api in their case)
  13 . 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