edit

Author: norareidy

source/crud/transactions.txt

@@ -27,6 +27,10 @@ transaction is committed. If any operation in the transaction returns an
 error, the driver cancels the transaction and discards all data changes
 before they ever become visible.
 
+In MongoDB, transactions run within logical **sessions**. A
+session is a grouping of related read or write operations that you
+intend to run sequentially. 
+
 When using the {+driver-short+}, you can create a new session from a 
 ``MongoClient`` instance as a ``ClientSession`` type. We recommend that you reuse
 your client for multiple sessions and transactions instead of
@@ -47,10 +51,6 @@ instantiating a new client each time.
 Causal Consistency
 ~~~~~~~~~~~~~~~~~~
 
-In MongoDB, transactions run within logical **sessions**. A
-session is a grouping of related read or write operations that you
-intend to run sequentially. 
-
 MongoDB enables **causal consistency** in client sessions, which allows
 you to execute operations in an :website:`ACID transaction </basics/acid-transactions>`.
 The causal consistency model guarantees that operations within a session
@@ -71,8 +71,8 @@ causal relationship between the following operations:
    To learn more about the concepts mentioned in this section, see the 
    following {+mdb-server+} manual entries:
 
-   - :manual:`Server Sessions </reference/server-sessions/>`
    - :manual:`Causal Consistency </core/read-isolation-consistency-recency/#causal-consistency>`
+   - :manual:`Causal Consistency and Read and Write Concerns </core/causal-consistency-read-write-concerns/>`
 
 Methods
 -------