DOCSP-24606: add info about v4.8 server breaking change and upgrading (#294)

* DOCSP-24606: add info about v4.8 server breaking change and upgrading

Author: Chris Cho

snooty.toml

@@ -19,6 +19,7 @@ driver = "java"
 driver-long = "MongoDB Java Driver"
 version = "4.8"
 full-version = "{+version+}.0-beta0"
+mdb-server = "MongoDB server"
 
 package-name-org = "mongodb-org"
 api = "https://mongodb.github.io/mongo-java-driver/{+version+}"

source/upgrade.txt

@@ -21,46 +21,22 @@ application to upgrade your driver to a new version.
 
 Before you upgrade, perform the following actions:
 
-- Ensure the new version is compatible with the MongoDB server versions
+- Ensure the new version is compatible with the {+mdb-server} versions
   your application connects to and the Java Runtime Environment (JRE) your
   application runs on. See the :ref:`Java Compatibility <java-compatibility-tables>`
   page for this information.
 - Address any breaking changes between the current version of the driver
   your application is using and your planned upgrade version in the
-  section on :ref:`Breaking Changes <java-breaking-changes>` below.
+  :ref:`Breaking Changes <java-breaking-changes>` section. To learn
+  more about the {+mdb-server+} release compatibility changes, see the
+  :ref:`<java-server-release-changes>` section.
 
 .. tip::
 
    To minimize the amount of changes your application may require when
    upgrading driver versions in the future, use the
    :ref:`{+stable-api+} <stable-api-java>`.
 
-.. _java-server-release-changes:
-
-Server Release Compatibility Changes
-------------------------------------
-
-A server release compatibility change is a modification
-to the {+driver-long+} that discontinues support for a set of
-MongoDB server versions.
-
-To learn more about end-of-life MongoDB products,
-see the `Legacy Support Policy <https://www.mongodb.com/support-policy/legacy>`__.
-
-.. _java-server-release-change-v4.8:
-
-Version 4.8 Server Release Support Changes
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-- The v4.8 driver drops support for MongoDB v3.4 and earlier.
-  To use the v4.8 driver, your MongoDB server must be v3.6 or later. To learn
-  how to upgrade your MongoDB server to v3.6, follow the link corresponding
-  to your MongoDB configuration:
-
-  - :ref:`<3.6-upgrade-replica-set>`
-  - :ref:`<3.6-upgrade-standalone>`
-  - :ref:`<3.6-upgrade-sharded-cluster>`
-
 .. _java-breaking-changes:
 
 Breaking Changes
@@ -76,6 +52,14 @@ 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-v4.8:
+
+Version 4.8 Breaking Changes
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+- The driver ends support for connecting to {+mdb-server+} versions v3.4 and
+  earlier. To learn more about this change, see the :ref:`<java-server-release-change-v4.8>`
+  section.
 
 .. _java-breaking-changes-v4.7:
 
@@ -148,3 +132,31 @@ Version 4.0 Breaking Changes
   any classes that link to the driver against this version or later to ensure
   that they continue to work.
 
+.. _java-server-release-changes:
+
+Server Release Compatibility Changes
+------------------------------------
+
+A server release compatibility change is a modification
+to the {+driver-long+} that discontinues support for a set of
+{+mdb-server+} versions.
+
+The driver discontinues support for a {+mdb-server+} version after it reaches
+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-v4.8:
+
+Version 4.8 Server Release Support Changes
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+- The v4.8 driver drops support for {+mdb-server+} v3.4 and earlier.
+  To use the v4.8 driver, your {+mdb-server+} must be v3.6 or later. To learn
+  how to upgrade your {+mdb-server+} to v3.6, follow the link that corresponds 
+  to your MongoDB deployment configuration:
+
+  - :ref:`<3.6-upgrade-replica-set>`
+  - :ref:`<3.6-upgrade-standalone>`
+  - :ref:`<3.6-upgrade-sharded-cluster>`

source/whats-new.txt

@@ -32,8 +32,8 @@ What's New in 4.8
 -------------------
 
 The 4.8 driver ends support for MongoDB v3.4 and earlier. To learn
-how to upgrade your driver to v4.8, see
-:ref:`<java-server-release-change-v4.8>`.
+more about breaking changes in this driver version and how to address 
+them, see :ref:`<java-server-release-change-v4.8>`.
 
 .. _version-4.7.1:
 .. _version-4.7: