DOCSP-24523-read-concern-definition (#1755) (#1761)

jason-price-mongodb · jason-price-mongodb · web-flow · commit ba2ed1bfcdb5 · 2022-09-02T10:17:19.000-07:00
* DOCSP-24523-read-concern-definition * DOCSP-24523-read-concern-definition * DOCSP-24523-read-concern-definition * DOCSP-24523-read-concern-definition * DOCSP-24523-read-concern-definition * DOCSP-24523-read-concern-definition * DOCSP-24523-read-concern-definition * DOCSP-24523-read-concern-definition * DOCSP-24523-read-concern-definition Co-authored-by: jason-price-mongodb <jshfjghsdfgjsdjh@aolsdjfhkjsdhfkjsdf.com> Co-authored-by: jason-price-mongodb <jshfjghsdfgjsdjh@aolsdjfhkjsdhfkjsdf.com>
diff --git a/source/includes/snapshot-definition.rst b/source/includes/snapshot-definition.rst
@@ -0,0 +1,5 @@
+A snapshot is a complete copy of the data in a :binary:`mongod` instance
+at a specific point in time. You can retrieve snapshot metadata for the
+whole cluster or replica set, or for a single config server in a
+cluster. For more details, see `snapshots
+<https://www.mongodb.com/docs/cloud-manager/reference/api/snapshots>`__.
diff --git a/source/reference/glossary.txt b/source/reference/glossary.txt
@@ -929,6 +929,9 @@ Glossary
       consistency and is the replication topology employed by MongoDB.
       See :doc:`/core/replica-set-primary`.
 
+   snapshot
+      .. include:: /includes/snapshot-definition.rst
+
    snappy
       A compression/decompression library designed to balance
       efficient computation requirements with reasonable compression rates.
diff --git a/source/reference/read-concern-snapshot.txt b/source/reference/read-concern-snapshot.txt
@@ -17,10 +17,12 @@ Read Concern ``"snapshot"``
 Read concern ``"snapshot"`` is only available for :doc:`multi-document
 transactions </core/transactions>`.
 
+.. include:: /includes/snapshot-definition.rst
+
 - If the transaction is not part of a :ref:`causally consistent session
   <sessions>`, upon transaction commit with write concern
   :writeconcern:`"majority"`, the transaction operations are guaranteed
-  to have read from a snapshot of majority-committed data.
+  to have read from a :term:`snapshot` of majority-committed data.
 
 - If the transaction is part of a :ref:`causally consistent session
   <sessions>`, upon transaction commit with write concern
diff --git a/source/reference/read-concern.txt b/source/reference/read-concern.txt
@@ -24,7 +24,6 @@ of consistency and availability guarantees as appropriate, such as
 waiting for stronger consistency guarantees, or loosening consistency
 requirements to provide higher availability.
 
-
 MongoDB drivers updated for MongoDB 3.2 or later support specifying
 read concern.
 
@@ -186,7 +185,9 @@ The following read concern levels are available:
 
    * - :readconcern:`"snapshot"`
 
-     - | If the transaction is not part of a :ref:`causally consistent
+     - .. include:: /includes/snapshot-definition.rst
+     
+       | If the transaction is not part of a :ref:`causally consistent
          session <sessions>`, upon transaction commit with write
          concern :writeconcern:`"majority"`, the transaction operations
          are guaranteed to have read from a snapshot of
@@ -225,7 +226,6 @@ For more information on each read concern level, see:
 - :doc:`/reference/read-concern-snapshot`
 - :doc:`/reference/mongodb-defaults`
 
-
 ``readConcern`` Support
 -----------------------
 
@@ -290,7 +290,6 @@ concern.
 For more information, see :ref:`Transaction Read Concern
 <transactions-read-concern>`.
 
-
 Causally Consistent Sessions and Available Read Concerns
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
