From afb510a66dc42ddee83ad35ff448efcf6b688fa4 Mon Sep 17 00:00:00 2001
From: Rea Rustagi <85902999+rustagir@users.noreply.github.com>
Date: Tue, 19 Nov 2024 15:13:09 -0500
Subject: [PATCH] DOCSP-39159: v5.2 removal of support for 3.6 (#591)

* DOCSP-39159: v5.2 removal of support for 3.6

* vale action

* add upgrade guide
---
 .github/workflows/vale-tdbx.yml               | 13 ++++++++-----
 .../mongodb-compatibility-table-java.rst      |  2 +-
 source/upgrade.txt                            | 19 +++++++++++++++++++
 source/whats-new.txt                          |  9 ++++++++-
 4 files changed, 36 insertions(+), 7 deletions(-)

diff --git a/.github/workflows/vale-tdbx.yml b/.github/workflows/vale-tdbx.yml
index 284033abe..d748e941c 100644
--- a/.github/workflows/vale-tdbx.yml
+++ b/.github/workflows/vale-tdbx.yml
@@ -12,23 +12,26 @@ jobs:
       - name: checkout
         uses: actions/checkout@master
 
+      - name: Install docutils
+        run: sudo apt-get install -y docutils
+
       - id: files
         uses: masesgroup/retrieve-changed-files@v2
         with:
-          format: 'csv'
+          format: "csv"
 
       - name: checkout-latest-rules
         uses: actions/checkout@master
         with:
           repository: mongodb/mongodb-vale-action
-          path: './tdbx-vale-rules'
+          path: "./tdbx-vale-rules"
           token: ${{secrets.GITHUB_TOKEN}}
 
       - name: move-files-for-vale-action
         run: |
-            cp tdbx-vale-rules/.vale.ini .vale.ini
-            mkdir -p .github/styles/
-            cp -rf tdbx-vale-rules/.github/styles/ .github/
+          cp tdbx-vale-rules/.vale.ini .vale.ini
+          mkdir -p .github/styles/
+          cp -rf tdbx-vale-rules/.github/styles/ .github/
 
       - name: run-vale
         uses: errata-ai/vale-action@reviewdog
diff --git a/source/includes/mongodb-compatibility-table-java.rst b/source/includes/mongodb-compatibility-table-java.rst
index e3160d436..7cae8a3dc 100644
--- a/source/includes/mongodb-compatibility-table-java.rst
+++ b/source/includes/mongodb-compatibility-table-java.rst
@@ -23,7 +23,7 @@
      - ✓
      - ✓
      - ✓
-     - ✓
+     -
 
    * - 4.10 to 5.1
      - ⊛
diff --git a/source/upgrade.txt b/source/upgrade.txt
index e2223752c..9b76364f8 100644
--- a/source/upgrade.txt
+++ b/source/upgrade.txt
@@ -56,6 +56,15 @@ changes between the current and upgrade versions. For example, if you
 are upgrading the driver from v4.0 to v4.5, address all breaking changes from
 the version after v4.0 including any listed under v4.5.
 
+.. _java-breaking-changes-v5.2:
+
+Version 5.2 Breaking Changes
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+- The driver is no longer compatible with {+mdb-server+} version
+  v3.6. To learn more about this change, see the
+  :ref:`<java-server-release-change-v5.2>` section.
+
 .. _java-breaking-changes-v5.0:
 
 Version 5.0 Breaking Changes
@@ -435,6 +444,16 @@ end-of-life (EOL).
 To learn more about the MongoDB support for EOL products,
 see the `Legacy Support Policy <https://www.mongodb.com/support-policy/legacy>`__.
 
+.. _java-server-release-change-v5.2:
+
+Driver Version 5.2 Server Support Changes
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+The v5.2 driver drops support for {+mdb-server+} v3.6.
+To use the v5.2 driver, your {+mdb-server+} must be v4.0 or later. To
+learn how to upgrade your {+mdb-server+} deployment, see
+:manual:`Release Notes </release-notes>` in the {+mdb-server+} manual.
+
 .. _java-server-8.1-incompatibility:
 
 Server Version 8.1 Support Changes
diff --git a/source/whats-new.txt b/source/whats-new.txt
index 8850468ae..fff6872ec 100644
--- a/source/whats-new.txt
+++ b/source/whats-new.txt
@@ -49,7 +49,14 @@ The 5.2.1 driver patch release includes the following changes:
 What's New in 5.2
 -----------------
 
-New features of the 5.2 driver release include:
+.. important:: Removal of Support for {+mdb-server+} 3.6
+
+   {+driver-short+} v5.2 removes support for {+mdb-server+} 3.6. To
+   learn more about compatible versions of the server, see
+   :ref:`java-compatibility-tables`.
+
+The 5.2 driver release includes the following changes, fixes,
+and features:
 
 - A forward-slash (``/``) character between the host names and client
   options in a connection URI is optional. The driver parses the