DOCSP-30350 Write exceptions, reorg

Author: mballard-mdb

source/crud/operation-error-handling.txt

@@ -35,7 +35,7 @@ appropriate actions to either handle them or correct the error-causing code.
       discussions, or general technical support
 
 Write Error
-~~~~~~~~~~~
+-----------
 
 If the driver encounters an error while performing a write operation, it
 creates an error of the `WriteError <{+core-api+}/WriteError.html>`__ type.
@@ -48,8 +48,22 @@ The ``WriteError`` type contains the following fields:
 
 .. _java_error_write_exceptions:
 
+Write Exception Types
+---------------------
+
+The driver creates write exceptions when a ``WriteError`` object is created.
+
+The write exception object contains the following fields:
+
+  - ``error``: the ``WriteError`` object that triggered the exception
+  - ``serverAddress``: the address of the server where the exception occurred
+  - ``errorLabels``: the server error labels, such as ``RetryableWriteError`` and ``TransientTransactionError``
+
+Details on the different types of write exceptions and the error messages that
+are thrown when one is created can be found below.
+
 Write Exception
----------------
+~~~~~~~~~~~~~~~
 
 The driver raises a `MongoWriteException <{+core-api+}/MongoWriteException.html>`__ for
 any errors that it encounters when performing single write operations that are
@@ -83,14 +97,14 @@ either revise the document to adhere to the schema validation rules or bypass
 validation.
 
 Bulk Write Exception
---------------------
+~~~~~~~~~~~~~~~~~~~~
 
 If the same example were run as a bulk write operation, a
 `MongoBulkWriteException <{+core-api+}/MongoBulkWriteException.html>`__ would be
-thrown. A ``MongoBulkWriteException`` can contain a list of errors associated
-with the same bulk write operation. For example, if you attempt to insert two
-documents that violate the collection's schema, the error message would appear
-as follows:
+thrown. A ``MongoBulkWriteException`` contains a list of errors associated with
+the same bulk write operation if more than one item caused an error. For
+example, if you attempt to insert two documents that violate the collection's
+schema, the driver prints the following error message:
 
 .. code-block:: none
    :copyable: false
@@ -106,9 +120,9 @@ as follows:
    schemaRules: { bsonType: "int", description: "must be an integer" },
    offendingDocument: {"name":"Apple","quantity":"three"} }} at
    com.mongodb.internal.connection.WriteResultHelper.createWriteException(WriteResultHelper.java:50)
-   at
-   com.mongodb.internal.connection.ProtocolHelper.getBulkWriteException(ProtocolHelper.java:254)
-   ... 19 more Caused by: com.mongodb.MongoWriteException: WriteError{code=121,
+   at com.mongodb.internal.connection.ProtocolHelper.getBulkWriteException(ProtocolHelper.java:254)
+   ... 19 more 
+   Caused by: com.mongodb.MongoWriteException: WriteError{code=121,
    message='Document failed validation', details={ operator: "$jsonSchema",
    schemaRules: { bsonType: "int", description: "must be an integer" },
    offendingDocument: {"name":"Banana","quantity":"ten"} }} at