DOCS-766 verify bulk inserts

Author: Bob Grabar

source/includes/note-bulk-inserts-on-sharded-clusters.rst

@@ -0,0 +1,5 @@
+.. note::
+
+   For bulk inserts on sharded clusters, the :dbcommand:`getLastError`
+   command alone is insufficient to verify success. Your application
+   must also verify bulk inserts through application logic.

source/reference/method/db.collection.insert.txt

@@ -14,6 +14,10 @@ db.collection.insert()
       an array of documents to perform a bulk insert of the
       documents into the collection.
 
+      .. include:: /includes/note-bulk-inserts-on-sharded-clusters.rst
+
+      .. todo:: for 2.4, remove: /includes/note-bulk-inserts-on-sharded-clusters.rst
+
    Consider the following behaviors of the :method:`insert()
    <db.collection.insert()>` method:
 

source/release-notes/2.0.txt

@@ -330,6 +330,8 @@ most recent :dbcommand:`getLastError` results.
 
 See :wiki:`OP_INSERT <Mongo+Wire+Protocol#MongoWireProtocol-OPINSERT>`.
 
+.. include:: /includes/note-bulk-inserts-on-sharded-clusters.rst
+
 Map Reduce
 ~~~~~~~~~~
 

source/release-notes/2.2.txt

@@ -584,6 +584,8 @@ If you pass an array of :term:`documents <document>` to the
 shell will now perform a bulk insert operation. See
 :issue:`SERVER-3819` and :issue:`SERVER-2395` for more information.
 
+.. include:: /includes/note-bulk-inserts-on-sharded-clusters.rst
+
 Operations
 ~~~~~~~~~~
 

source/tutorial/manage-chunks-in-sharded-cluster.txt

@@ -312,11 +312,9 @@ Strategies for Bulk Inserts in Sharded Clusters
 .. todo:: link the words "bulk insert" to the bulk insert topic when
    it's published
 
-
-Large bulk insert operations including initial data ingestion or
+Large bulk insert operations, including initial data ingestion or
 routine data import, can have a significant impact on a :term:`sharded
-cluster`. Consider the following strategies and possibilities for
-bulk insert operations:
+cluster`. For bulk insert operations, consider the following strategies:
 
 - If the collection does not have data, then there is only one
   :term:`chunk`, which must reside on a single shard. MongoDB must
@@ -370,3 +368,7 @@ bulk insert operations:
   and see :ref:`Shard Key Internals <sharding-internals-shard-keys>` (in
   particular, :ref:`sharding-internals-operations-and-reliability` and
   :ref:`sharding-internals-choose-shard-key`).
+
+.. todo:: remove the below include for 2.4
+
+.. include:: /includes/note-bulk-inserts-on-sharded-clusters.rst