DOCSP-26913: Added reference to upsertDocument option (#148)

* DOCSP-26913: Added reference to upsertDocument option

* Added clarifications based on recommendations.

Author: DBirtolo-mdb

source/configuration/write.txt

@@ -72,11 +72,13 @@ The following options for writing to MongoDB are available:
 
        - ``insert``: insert the data.
        - ``replace``: replace an existing document that matches the
-         ``idFieldList`` value with the new data, or insert the data if
-         no match exists.
+         ``idFieldList`` value with the new data. If no match exists, the
+         value of ``upsertDocument`` indicates whether or not the connector
+         inserts a new document.
        - ``update``: update an existing document that matches the
-         ``idFieldList`` value with the new data, or inserts the data if
-         no match exists.
+         ``idFieldList`` value with the new data. If no match exists, the
+         value of ``upsertDocument`` indicates whether or not the connector
+         inserts a new document.
 
        |
        | **Default:** ``replace``
@@ -130,6 +132,15 @@ The following options for writing to MongoDB are available:
          guide on the
          :manual:`WriteConcern wtimeout option </reference/write-concern/#wtimeout>`.
 
+   * - ``upsertDocument``
+     - | When ``true``, replace and update operations will insert the data
+         if no match exists.
+       |
+       | For time series collections, you must set ``upsertDocument`` to
+         ``false``.
+       |
+       | **Default:** ``true``
+
 .. _configure-output-uri:
 
 ``connection.uri`` Configuration Setting