diff options
| author | Mike Bayer <mike_mp@zzzcomputing.com> | 2018-01-31 09:27:03 -0500 |
|---|---|---|
| committer | Mike Bayer <mike_mp@zzzcomputing.com> | 2018-01-31 09:28:08 -0500 |
| commit | 5146c0b40273f47faa37da19a3d79c5c5e196195 (patch) | |
| tree | eb45b09a3f9d25a8f6dde28df0cb9397eaf12d4e | |
| parent | a5d43fdef0f2774c0376743597fe94e74e2dabf5 (diff) | |
| download | sqlalchemy-5146c0b40273f47faa37da19a3d79c5c5e196195.tar.gz | |
- don't scare off developers with the word "advanced" here
Change-Id: I72a0295634e228bacf6c92088e650183f91e4585
(cherry picked from commit 399988aaed401ea6fc69aa580b9b71c236a30f16)
| -rw-r--r-- | doc/build/orm/session_basics.rst | 9 |
1 files changed, 6 insertions, 3 deletions
diff --git a/doc/build/orm/session_basics.rst b/doc/build/orm/session_basics.rst index 18610d3f0..c71b23427 100644 --- a/doc/build/orm/session_basics.rst +++ b/doc/build/orm/session_basics.rst @@ -362,9 +362,12 @@ Keep the lifecycle of the session (and usually the transaction) finally: session.close() -The advanced developer will try to keep the details of session, transaction -and exception management as far as possible from the details of the program -doing its work. For example, we can further separate concerns using a `context manager <http://docs.python.org/3/library/contextlib.html#contextlib.contextmanager>`_:: +The most comprehensive approach, recommended for more substantial applications, +will try to keep the details of session, transaction and exception management +as far as possible from the details of the program doing its work. For +example, we can further separate concerns using a `context manager +<http://docs.python.org/3/library/co +ntextlib.html#contextlib.contextmanager>`_:: ### another way (but again *not the only way*) to do it ### |