From f655b57272371e9adacb9a9e64057f2298d96eef 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/core/retryable-writes.txt | 13 ++++++++++---
 1 file changed, 10 insertions(+), 3 deletions(-)

diff --git a/source/core/retryable-writes.txt b/source/core/retryable-writes.txt
index ec6f1d1d675..a4e65b603cf 100644
--- a/source/core/retryable-writes.txt
+++ b/source/core/retryable-writes.txt
@@ -73,9 +73,16 @@ For more information on transactions, see :doc:`/core/transactions`.
 Enabling Retryable Writes
 -------------------------
 
-MongoDB drivers do **not** enable retryable writes by default with the
-exception of :ref:`transaction commit and abort operations
-<transactions-retry>`.
+MongoDB 3.6 introduced support for :ref:`retryable-writes`, but most
+official MongoDB 3.6 and 4.0-compatible drivers disable this feature
+by default. For such drivers, retryable writes can be enabled per
+connection by including the :urioption:`retryWrites=true
+<retryWrites>` option in the :ref:`connection string <mongodb-uri>`
+for that connection (see below). 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.
 
 MongoDB Drivers
   To enable retryable writes in MongoDB drivers, add the