DOCSP-30350 Updating grammar and Write/bulk Write error messages

Author: mballard-mdb

source/crud/operation-error-handling.txt

@@ -37,7 +37,7 @@ appropriate actions to either handle them or correct the error-causing code.
 Write Error Types
 -----------------
 
-If the driver encounters an error while performing an write operation, it
+If the driver encounters an error while performing a write operation, it
 returns an error of the `WriteError <{+core-api+}/WriteError.html>`__ type.
 
 The ``WriteError`` type contains the following methods: 
@@ -61,6 +61,8 @@ methods, ``WriteConcernError`` has the ``getCodeName`` method, which returns the
 name associated with the error code. This type does not have the ``getCategory``
 method.
 
+.. _java_error_write_errors:
+
 Write Error
 ~~~~~~~~~~~
 
@@ -70,15 +72,15 @@ satisfying the write concern.
 
 For example, the driver raises a ``WriteError`` error if you attempt to insert a
 document into a collection with an ObjectId value that already exists in the
-collection. Suppose the collection has an existing document with an ``ObjectId`` of `1`. If you attempt to insert a document
+collection. Suppose the collection has an existing document with an ``ObjectId`` of `1`. If you attempt to insert another document
 where the value of ``ObjectId`` is ``1``, the driver prints the following
 error message:
 
 .. code-block:: none
    :copyable: false
 
    WriteError: { code: 11000, message: "E11000 duplicate key error collection:
-   testDB.testCollection index: _id_ dup key: { _id: 1 }", details: {} } 
+   testDB.testCollection index: _id_ dup key: { _id: 1 }", details: Document{{}}} } 
 
 In the preceding error message, the ``message`` field describes the reason for
 the error, and the ``details`` field provides specific details about the failing
@@ -88,17 +90,18 @@ operation. To address this error, you must revise the document to have a unique
 Bulk Write Error
 ----------------
 
-If this same example was run in during bulk write operation, an additional field
-would be added to the error detailing the index of the item with the duplicate
-``ObjectId``
+If the same example were run as a bulk write operation, the `index` field
+containing the index of the item with the duplicate ``ObjectId`` would be added
+to the message. For example, if the index of the item that produced the error is
+`2`, the driver would print the following error message:
 
 .. code-block:: none
    :copyable: false
    :emphasize-lines: 1
 
-   BulkWriteError{index=2, code=11000, message='E11000 duplicate key error
+   BulkWriteError{ index: 2, code: 11000, message: 'E11000 duplicate key error
    collection: testDB.testCollection index: _id_ dup key: { _id: 1 }',
-   details=Document{{}}}
+   details: Document{{}} }
 
 Write Concern Error
 ~~~~~~~~~~~~~~~~~~~