summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--doc/build/orm/session_basics.rst9
1 files changed, 6 insertions, 3 deletions
diff --git a/doc/build/orm/session_basics.rst b/doc/build/orm/session_basics.rst
index de0dd1e3a..391c6131d 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 ###