diff --git a/source/includes/extracts-4.2-changes.yaml b/source/includes/extracts-4.2-changes.yaml index a66d98933e2..cbbcb25abb0 100644 --- a/source/includes/extracts-4.2-changes.yaml +++ b/source/includes/extracts-4.2-changes.yaml @@ -704,9 +704,15 @@ content: | --- ref: 4.2-changes-drivers-retryWrites-default content: | - The official MongoDB 3.6 and 4.0-compatible drivers required including the - :urioption:`retryWrites=true ` option in the :ref:`connection - string ` to enable retryable writes for that connection. + MongoDB 3.6 introduced support for :ref:`retryable-writes`, but most + official MongoDB 3.6 and 4.0-compatible drivers disabled this feature + by default. For such drivers, retryable writes could be enabled per + connection by including the :urioption:`retryWrites=true + ` option in the :ref:`connection string ` + for that connection. Refer to the `MongoDB Driver Documentation + `_ to determine + the correct default state of :urioption:`retryWrites` for your + specific driver and version. The official MongoDB 4.2-compatible drivers enable :ref:`retryable-writes` by default. Applications upgrading to the 4.2-compatible drivers that require