DOCSP-47041: Causal consistency

Author: norareidy

source/crud/transactions.txt

@@ -27,16 +27,6 @@ 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
-:manual:`session </reference/server-sessions/>` is a grouping of related
-read or write operations that you intend to run sequentially. Sessions
-enable :manual:`causal consistency
-</core/read-isolation-consistency-recency/#causal-consistency>` for a
-group of operations or allow you to execute operations in an
-:website:`ACID transaction </basics/acid-transactions>`. MongoDB
-guarantees that the data involved in your transaction operations remains
-consistent, even if the operations encounter unexpected errors.
-
 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
@@ -54,6 +44,36 @@ instantiating a new client each time.
    You must include the ``session`` as a parameter for any operations that you
    want to include in a transaction.
 
+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
+run in a causal order. Additionally, clients observe results that
+are consistent with the causal relationships, or the dependencies between
+operations. If you perform a series of operations where one operation
+logically depends on the result of another, any subsequent
+reads reflect the dependent relationship.
+
+In a causally consistent session, MongoDB ensures a
+causal relationship between the following operations:
+
+- Read operations that have a ``MAJORITY`` read concern
+- Write operations that have a ``MAJORITY`` write concern
+
+.. tip::
+
+   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>`
+
 Methods
 -------