NR feedback

Author: rachel-mack

source/crud/read-operations/retrieve.txt

@@ -99,11 +99,10 @@ Find Example: Full File
 
 .. include:: /includes/crud/example-intro.rst
 
-The following code is a complete, standalone file that performs the following
-actions:
+This example is a complete, standalone file that performs the following actions:
 
-- Calls the ``find()`` method to retrieve multiple documents that have a ``runtime`` value less than 15, applying a projection and sort to the results 
-- Calls the ``find()`` and ``first()`` method to retrieve a document that has a ``title`` value of ``"The Room"``, applying a projection and sort before returning the first match 
+- Calls the ``find()`` method to retrieve multiple documents that have a ``runtime`` value less than ``15``, applying a projection and sort to the results 
+- Calls the ``find()`` and ``first()`` methods to retrieve a document that has a ``title`` value of ``"The Room"``, applying a projection and sort before returning the first match 
 
 .. io-code-block::
 
@@ -176,7 +175,7 @@ API Documentation
 ~~~~~~~~~~~~~~~~~
 
 For more information about the methods and classes used to retrieve documents
-on this page, see the following API cocumentation:
+on this page, see the following API documentation:
 
 - `find() <{+api+}/apidocs/mongodb-driver-sync/com/mongodb/client/MongoCollection.html#find()>`__
 - `first() <{+api+}/apidocs/mongodb-driver-sync/com/mongodb/client/MongoIterable.html#first()>`__

source/crud/write-operations/bulk.txt

@@ -370,7 +370,7 @@ actions:
 
 #. Creates a list of instances of the ``InsertOneModel``, ``UpdateOneModel``,
    ``DeleteOneModel``, and ``ReplaceOneModel`` classes.
-#. Runs an ordered ``bulkWrite()`` operation on the list.
+#. Runs an ordered ``bulkWrite()`` operation that performs the writes specified in the model list.
 
 .. io-code-block::
 
@@ -652,7 +652,7 @@ MongoCollection
 - `MongoBulkWriteException <{+api+}/apidocs/mongodb-driver-core/com/mongodb/MongoBulkWriteException.html>`__
 
 MongoClient
-````````````
+```````````
 
 - `bulkWrite() <{+api+}/apidocs/mongodb-driver-sync/com/mongodb/client/MongoCluster.html#bulkWrite(com.mongodb.client.ClientSession,java.util.List)>`__
 - `ClientBulkWriteOptions <{+api+}/apidocs/mongodb-driver-core/com/mongodb/client/model/bulk/ClientBulkWriteOptions.html>`__

source/crud/write-operations/delete.txt

@@ -154,7 +154,7 @@ Delete Example: Full File
 .. include:: /includes/crud/example-intro.rst
 
 The following code is a complete, standalone file that performs a delete one
-operation and a delete many operation. 
+operation and a delete many operation: 
 
 .. io-code-block::
 
@@ -166,11 +166,11 @@ operation and a delete many operation.
       :language: none
       :visible: false
 
-      DeleteOne document count: 1
-      DeleteMany document count: 4
+      deleteOne() document count: 1
+      deleteMany() document count: 4
 
 
-The query in this examples uses the ``eq()`` and ``lt()`` filters to query documents. For more
+The queries in these examples use the ``eq()`` and ``lt()`` filters to query documents. For more
 information about filters, see the `Filters Class
 <{+api+}/apidocs/mongodb-driver-core/com/mongodb/client/model/Filters.html>`__
 API documentation.
@@ -181,7 +181,7 @@ Additional Information
 API Documentation
 ~~~~~~~~~~~~~~~~~
 
-For more information about the methods and classes used to delete documents, see the following API cocumentation: 
+For more information about the methods and classes used to delete documents, see the following API documentation: 
 
 - `deleteOne() <{+api+}/apidocs/mongodb-driver-sync/com/mongodb/client/MongoCollection.html#deleteOne(org.bson.conversions.Bson)>`__  
 - `deleteMany() <{+api+}/apidocs/mongodb-driver-sync/com/mongodb/client/MongoCollection.html#deleteMany(org.bson.conversions.Bson)>`__ 

source/crud/write-operations/insert.txt

@@ -162,7 +162,7 @@ Insert Example: Full File
 .. include:: /includes/crud/example-intro.rst
 
 The following code is a complete, standalone file that performs an insert one
-operation and an insert many operation. 
+operation and an insert many operation: 
 
 .. io-code-block::
 
@@ -174,16 +174,16 @@ operation and an insert many operation.
       :language: none
       :visible: false
 
-      InsertOne document id: BsonObjectId{value=...}
-      InsertMany document ids: {0=BsonObjectId{value=...}, 1=BsonObjectId{value=...}}
+      insertOne() document id: BsonObjectId{value=...}
+      insertMany() document ids: {0=BsonObjectId{value=...}, 1=BsonObjectId{value=...}}
 
 Additional Information
 ----------------------
 
 API Documentation
 ~~~~~~~~~~~~~~~~~
 
-For more information about the methods and classes used to insert documents, see the following API cocumentation: 
+For more information about the methods and classes used to insert documents, see the following API documentation: 
 
 - `insertOne() <{+api+}/apidocs/mongodb-driver-sync/com/mongodb/client/MongoCollection.html#insertOne(TDocument)>`__
 - `InsertOneResult <{+api+}/apidocs/mongodb-driver-core/com/mongodb/client/result/InsertOneResult.html>`__

source/crud/write-operations/modify.txt

@@ -166,11 +166,11 @@ documents match.
 Update Example: Full File
 ~~~~~~~~~~~~~~~~~~~~~~~~~
 
-The following code is a complete, standalone file that performs an update one
-operation and an update many operation. 
-
 .. include:: /includes/crud/example-intro.rst
 
+The following code is a complete, standalone file that performs an update one
+operation and an update many operation: 
+
 .. io-code-block::
 
    .. input:: /includes/crud/Update.java
@@ -297,29 +297,25 @@ The following code is a complete, standalone file that performs a replace one op
       :language: none
       :visible: false
 
-      UpdateOne modified document count: 1
+      updateOne() modified document count: 1
       Upserted ID: null
 
-      UpdateMany modified document count: 242
+      updateMany() modified document count: 242
 
 Additional Information
 ----------------------
 
 API Documentation
 ~~~~~~~~~~~~~~~~~
 
-For more information about the methods and classes used to modify documents, see the following API cocumentation:
+For more information about the methods and classes used on this page, see the following API documentation:
 
 - `updateOne() <{+api+}/apidocs/mongodb-driver-sync/com/mongodb/client/MongoCollection.html#updateOne(org.bson.conversions.Bson,java.util.List,com.mongodb.client.model.UpdateOptions)>`__
 - `updateMany() <{+api+}/apidocs/mongodb-driver-sync/com/mongodb/client/MongoCollection.html#updateMany(org.bson.conversions.Bson,java.util.List,com.mongodb.client.model.UpdateOptions)>`__
 - `UpdateOptions <{+api+}/apidocs/mongodb-driver-core/com/mongodb/client/model/UpdateOptions.html>`__
 - `replaceOne() <{+api+}/apidocs/mongodb-driver-sync/com/mongodb/client/MongoCollection.html#replaceOne(org.bson.conversions.Bson,TDocument)>`__
 - `ReplaceOptions <{+api+}/apidocs/mongodb-driver-core/com/mongodb/client/model/ReplaceOptions.html?is-external=true>`__
 - `UpdateResult <{+api+}/apidocs/mongodb-driver-core/com/mongodb/client/result/UpdateResult.html>`__
- 
-For more information about the methods used in the examples on this
-page, see the following API cocumentation:
-
 - `eq() <{+api+}/apidocs/mongodb-driver-core/com/mongodb/client/model/Filters.html#eq(java.lang.String,TItem)>`__
 - `combine() <{+api+}/apidocs/mongodb-driver-core/com/mongodb/client/model/Updates.html#combine(org.bson.conversions.Bson...)>`__
 - `set() <{+api+}/apidocs/mongodb-driver-core/com/mongodb/client/model/Updates.html#set(java.lang.String,TItem)>`__

source/includes/crud/Update.java

@@ -43,7 +43,7 @@ public static void main(String[] args) {
                 UpdateResult result = collection.updateOne(updateOneQuery, updateOneUpdates, options);
 
                 // Prints the number of updated documents and the upserted document ID, if an upsert was performed
-                System.out.println("UpdateOne modified document count: " + result.getModifiedCount());
+                System.out.println("updateOne() modified document count: " + result.getModifiedCount());
                 System.out.println("Upserted ID: " + result.getUpsertedId());
 
             // Prints a message if any exceptions occur during the operation
@@ -63,7 +63,7 @@ public static void main(String[] args) {
                 UpdateResult result = collection.updateMany(updateManyQuery, updateManyUpdates);
 
                 // Prints the number of updated documents
-                System.out.println("\nUpdateMany modified document count: " + result.getModifiedCount());
+                System.out.println("\nupdateMany() modified document count: " + result.getModifiedCount());
 
             // Prints a message if any exceptions occur during the operation
             } catch (MongoException me) {