DOCSP-32561: Exact versions in upgrade guide (#887)

* DOCSP-32561: Exact versions in upgrade guide

* fix

* RR feedback

(cherry picked from commit 6d2df34)
(cherry picked from commit f36bcf0)
(cherry picked from commit a632359)
(cherry picked from commit 9b035b7)

Author: norareidy

source/upgrade.txt

@@ -70,17 +70,17 @@ The breaking changes in this section are categorized by the major
 version releases that introduced them. When upgrading driver versions,
 address all the breaking changes between your current version and the
 planned upgrade version. For example, if you are upgrading the driver
-from v3.x to v5.x, address all breaking changes listed under v4.x and
-v5.x.
+from v3.x to v5.x, address all breaking changes listed under v4.0 and
+v5.0.
 
 .. _node-breaking-changes-v5.x:
+.. _node-breaking-changes-v5.0:
 
-Version 5.x Breaking Changes
+Version 5.0 Breaking Changes
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-- Driver versions 5.x are not compatible with Node.js
-  v12 or earlier. If you want to use this version of the driver, you must
-  use Node.js v14.20.1 or greater.
+- The driver is no longer compatible with Node.js v12 or earlier. If you want to use
+  this version of the driver, you must use Node.js v14.20.1 or greater.
 
 - The driver removes support for callbacks in favor of a promise-based API.
   The following list provides some strategies for callback users to adopt this
@@ -128,13 +128,13 @@ Version 5.x Breaking Changes
   - ``AsyncIterator`` interface removed in favor of ``AsyncGenerator``
 
 .. _node-breaking-changes-v4.x:
+.. _node-breaking-changes-v4.0:
 
-Version 4.x Breaking Changes
+Version 4.0 Breaking Changes
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-- Driver versions 4.x are not compatible with Node.js
-  v12.8 or earlier. If you want to use this version of the driver, You must
-  use Node.js v12.9 or greater.
+- The driver is no longer compatible with Node.js v12.8 or earlier. If you
+  want to use this version of the driver, you must use Node.js v12.9 or greater.
 
 - ``Cursor`` types no longer extend ``Readable`` directly.
 

source/whats-new.txt

@@ -237,32 +237,9 @@ What's New in 5.0
 
 .. important:: Breaking Changes in v5.0
 
-   - Version 5.0 of the {+driver-short+} is not compatible with Node.js
-     v12 or earlier. If you want to use this version of the driver, You must
-     use Node.js v14.20.1 or greater.
-
-   - This release removes support for callbacks in favor of a promise-based API.
-     The following list provides some strategies for callback users to adopt this
-     version:
-
-     - Migrate to the promise-based API (recommended)
-     - Use the promise-based API and ``util.callbackify``
-     - Add ``mongodb-legacy`` to continue using callbacks
-
-     For more information about these strategies, see
-     `Changes in the MongoDB Node.js Driver v5 <https://github.com/mongodb/node-mongodb-native/blob/main/etc/notes/CHANGES_5.0.0.md>`__.
-
-   - This release removes support for the ``Collection.insert()``,
-     ``Collection.update()``, and ``Collection.remove()`` helper methods.
-     The following list provides instructions on how to replace the
-     functionality of the removed methods:
-
-     - Migrate from ``Collection.insert()`` to ``insertOne()`` or ``insertMany()``
-     - Migrate from ``Collection.update()`` to ``updateOne()`` or ``updateMany()``
-     - Migrate from ``Collection.remove()`` to ``deleteOne()`` or ``deleteMany()``
-
-   To view a full list of breaking changes introduced in this version, see the :ref:`Breaking
-   Changes section <node-breaking-changes-v5.x>` in the Upgrade guide.
+   This driver version introduces breaking changes. For a list of these changes, see
+   the :ref:`Version 5.0 Breaking Changes section <node-breaking-changes-v5.0>` in the
+   Upgrade guide.
 
 New features of the 5.0 {+driver-short+} release include:
 
@@ -632,6 +609,12 @@ New features of the 4.1 Node.js driver release include:
 What's New in 4.0
 -----------------
 
+.. warning:: Breaking Changes in v4.0
+
+   This driver version introduces breaking changes. For a list of these changes, see
+   the :ref:`Version 4.0 Breaking Changes section <node-breaking-changes-v4.0>` in
+   the Upgrade guide.
+
 .. important::
 
    In this release of the driver, the deprecated ``collection.count()`` method was inadvertently changed to