(DOCS-15399): 6.1 retryable writes errors (#2066)

* (DOCS-15399): 6.1 retryable writes errors

* wording

* wording and minimalism

* fix include name

* edits

* add clarity

* reorder phrases

* minimalism

* minimalism, formatting

* review edits

* updates per review

* wording

* final review edits

* minimalism

Author: jeff-allen-mongo

source/core/retryable-writes.txt

@@ -366,3 +366,8 @@ disabled.
 To disable retryable writes, specify
 :urioption:`retryWrites=false <retryWrites>` in the 
 :ref:`connection string <mongodb-uri>` for the MongoDB cluster.
+
+Error Handling
+~~~~~~~~~~~~~~
+
+.. include:: /includes/6.1-retry-writes-error-handling.rst

source/includes/6.1-retry-writes-error-handling.rst

@@ -0,0 +1,32 @@
+Starting in MongoDB 6.1, if both the first and second attempt of a
+retryable write fail without a single write being performed, MongoDB
+returns an error with the ``NoWritesPerformed`` label.
+
+The ``NoWritesPerformed`` label differentiates the results of batch
+operations like :method:`~db.collection.insertMany()`. In an
+``insertMany`` operation, one of the following outcomes can occur:
+
+.. list-table::
+   :header-rows: 1
+
+   * - Outcome
+     - MongoDB Output
+
+   * - No documents are inserted.
+     - Error returned with ``NoWritesPerformed`` label.
+
+   * - Partial work done. (At least one document is inserted, but not
+       all.)
+     - Error returned without ``NoWritesPerformed`` label.
+
+   * - All documents are inserted.
+     - Success returned.
+
+Applications can use the ``NoWritesPerformed`` label to definitively
+determine that no documents were inserted. This error reporting lets the
+application maintain an accurate state of the database when handling
+retryable writes.
+
+In previous versions of MongoDB, an error is returned when both the
+first and second attempts of a retryable write fail. However, there is
+no distinction made to indicate that no writes were performed.

source/release-notes/6.1.txt

@@ -51,6 +51,17 @@ results in a slower query than one without the option specified.
 For an example that uses the ``*UCP`` option, see
 :ref:`regex-example-pcre2-ucp`.
 
+.. _release-notes-6.1-replication:
+
+Replication
+-----------
+
+.. _release-notes-6.1-retry-writes-errors:
+
+Retryable Writes Error Handling
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+.. include:: /includes/6.1-retry-writes-error-handling.rst
 
 General Changes
 ---------------
@@ -404,4 +415,3 @@ of the related projects.
    :hidden:
 
    /release-notes/6.1-compatibility
-