From 9b67d9daf69b2bf8a8440a5631b1b74153bba14a Mon Sep 17 00:00:00 2001
From: Andrew Feierabend <andrew.feierabend@mongodb.com>
Date: Tue, 9 Feb 2021 16:22:28 -0500
Subject: [PATCH] DOCS-14182 clarify retryable writes default

---
 source/includes/extracts-4.2-changes.yaml | 12 +++++++++---
 1 file changed, 9 insertions(+), 3 deletions(-)

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 <retryWrites>` option in the :ref:`connection
-   string <mongodb-uri>` 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
+   <retryWrites>` option in the :ref:`connection string <mongodb-uri>`
+   for that connection. Refer to the `MongoDB Driver Documentation
+   <https://docs.mongodb.com/drivers/?tck=docs_server>`_ 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