diff --git a/draft/core/write-operations.txt b/draft/core/write-operations.txt index 591d5ef9a41..3a32c9eec79 100644 --- a/draft/core/write-operations.txt +++ b/draft/core/write-operations.txt @@ -284,16 +284,18 @@ and :doc:`/applications/indexes`. Isolation --------- -All operations inside of a *single* MongoDB document are atomic. An -update operation may modify more than one sub-document within a single -MongoDB document (or record) in a single operation that will either -succeed or fail and cannot leave the document in an in-between state. +When a single write operation modifies multiple documents, the +operation as a whole is not atomic, and other operations may +interleave. The modification of a single document, or record, is always +atomic, even if the write operation modifies multiple sub-document +*within* the single record. No other operations are atomic; however, you can attempt to isolate a -sequence of write operations from other read and write operations to -prevent undesirable interactions. For more information see -:doc:`Isolated write operations ` and -:doc:`/tutorial/perform-two-phase-commits`. +write operation that affects multiple documents using the +:doc:`isolation operator `. + +To isolate a sequence of write operations from other read and write +operations, see :doc:`/tutorial/perform-two-phase-commits`. Architecture ------------