(DOCS-11076): Document inaccuracies when inserting documents (#2149) (#2187)

davidhou17 · web-flow · commit 2a7e4beb3a6c · 2022-11-22T16:16:24.000-05:00
* add information about insert inaccuracies

* copy review feedback

* tech review feedback
diff --git a/source/includes/fact-insert-inaccuracies.rst b/source/includes/fact-insert-inaccuracies.rst
@@ -0,0 +1,8 @@
+Even if you encounter a server error during an insert, some documents 
+may have been inserted. 
+
+After a successful insert, the system returns |writeResult|, the number 
+of documents inserted into the collection. If the insert 
+operation is interrupted by a replica set state change,
+the system may continue inserting documents. As a result,
+|writeResult| may report fewer documents than actually inserted.
diff --git a/source/reference/command/insert.txt b/source/reference/command/insert.txt
@@ -139,6 +139,14 @@ transaction.
 
 .. |operation| replace:: :dbcommand:`insert`
 
+Insert Inaccuracies
+~~~~~~~~~~~~~~~~~~~
+
+.. include:: /includes/fact-insert-inaccuracies.rst
+
+.. |writeResult| replace:: :data:`insert.n`
+
+
 Examples
 --------
 
diff --git a/source/reference/method/Bulk.insert.txt b/source/reference/method/Bulk.insert.txt
@@ -39,9 +39,15 @@ Description
         - Document to insert. The size of the document must be less than or
           equal to the :limit:`maximum BSON document size <BSON Document Size>`.
           
-          
-   
+Behavior
+--------
+
+Insert Inaccuracies
+~~~~~~~~~~~~~~~~~~~
+
+.. include:: /includes/fact-insert-inaccuracies.rst
 
+.. |writeResult| replace:: :data:`BulkWriteResult.nInserted`
 
 Example
 -------
