DOCSP-51036: Transactions

Author: norareidy

source/interact-data.txt

@@ -24,6 +24,7 @@ Interact with Data
    CRUD Operations </interact-data/crud>
    Specify a Query </interact-data/specify-a-query>
    Perform Raw Queries </interact-data/raw-queries>
+   Transactions </interact-data/transactions>
 
 In this section, you can learn how to use {+django-odm+} to interact with your
 MongoDB data.
@@ -36,3 +37,6 @@ MongoDB data.
 
 - :ref:`django-raw-queries`: Learn how to use MongoDB's aggregation pipeline syntax
   or the PyMongo driver to query your data.
+
+- :ref:`django-transactions`: Learn how to use {+framework+}'s transactions API
+  to run data operations within a transaction.

source/interact-data/transactions.txt

@@ -0,0 +1,28 @@
+.. _django-transactions:
+
+=========================
+Transactions and Sessions
+=========================
+
+.. facet::
+   :name: genre
+   :values: reference
+
+.. meta::
+   :keywords: code example, ACID compliance, multi-document
+
+.. contents:: On this page
+   :local:
+   :backlinks: none
+   :depth: 2
+   :class: singlecol
+
+Overview
+--------
+
+In this guide, you can learn how to use the {+django-odm+} to perform
+**transactions**. Transactions allow you to perform a series of operations
+that change data only if the entire transaction is committed.
+If any operation in the transaction does not succeed, the library stops the
+transaction and discards all data changes before they ever become
+visible. This feature is called **atomicity**.