DOCSP-24194: Breaking changes callouts (#368)

* DOCSP-24194: Breaking changes callouts

Author: Chris Cho

source/whats-new.txt

@@ -27,38 +27,41 @@ Learn what's new in:
 
 .. _upcoming-breaking-changes:
 
+Upcoming Breaking Changes
+-------------------------
+
+- `MapReduceIterable <{+api+}/apidocs/mongodb-driver-sync/com/mongodb/client/MapReduceIterable.html>`__
+  and map-reduce methods on `MongoCollection <{+api+}/apidocs/mongodb-driver-sync/com/mongodb/client/MongoCollection.html#mapReduce(com.mongodb.client.ClientSession,java.lang.String,java.lang.String)>`__
+  are deprecated in MongoDB v4.2 and later,  and will be replaced by the 
+  aggregation framework.
+
 .. _version-4.9:
 
 What's New in 4.9
 -----------------
 
 - Added a new exception to identify when a constructor annotated by
-  ``BsonCreator`` contains parameters with annotations other than 
+  ``BsonCreator`` contains parameters with annotations other than
   ``BsonProperty`` or ``BsonId``.
 - Changed the log message format for command monitoring messages reported
   by the ``org.mongodb.driver.protocol.command`` package.
-- Added support for the ``$documents`` aggregation pipeline stage to the 
-  `Aggregates <{+api+}/apidocs/mongodb-driver-core/com/mongodb/client/model/Aggregates#documents(java.util.List)>`__ 
+- Added support for the ``$documents`` aggregation pipeline stage to the
+  `Aggregates <{+api+}/apidocs/mongodb-driver-core/com/mongodb/client/model/Aggregates#documents(java.util.List)>`__
   helper class.
 - Added `MongoClientSettings.Builder.applyToLoggerSettings() <{+api+}/apidocs/mongodb-driver-core/com/mongodb/MongoClientSettings.Builder.html#applyToLoggerSettings(com.mongodb.Block)>`__
-  and `LoggerSettings.Builder.maxDocumentLength() <{+api+}/apidocs/mongodb-driver-core/com/mongodb/LoggerSettings.Builder.html#maxDocumentLength(int)>`__ 
-  methods that let you specify a maximum length for the extended JSON representation of a 
-  BSON document in a log message. 
+  and `LoggerSettings.Builder.maxDocumentLength() <{+api+}/apidocs/mongodb-driver-core/com/mongodb/LoggerSettings.Builder.html#maxDocumentLength(int)>`__
+  methods that let you specify a maximum length for the extended JSON representation of a
+  BSON document in a log message.
 
 .. _version-4.8:
 
 What's New in 4.8
 -----------------
 
-- The 4.8 driver ends support for MongoDB v3.4 and earlier. To learn
-  more about breaking changes in this driver version and how to address
-  them, see :ref:`<java-server-release-change-v4.8>`.
+.. warning:: Breaking Changes in v4.8
 
-- The ``RecordCodec`` now deserializes POJOs and record classes that are
-  specified as type parameters of ``List`` and ``Map`` fields of a record as
-  their respective classes. To learn more about this change and how this may 
-  affect the behavior of your application, see
-  :ref:`<java-breaking-changes-v4.8>`.
+   The v4.8 driver contains breaking changes. See :ref:`<java-breaking-changes-v4.8>` 
+   and :ref:`<java-server-release-change-v4.8>` for more information.
 
 .. important:: Deprecation Notice
 
@@ -92,7 +95,7 @@ New features of the 4.8 driver release include:
   when the ``showExpandedEvents`` server feature is enabled on MongoDB v6.1
   and later. Learn more about this field from the `getDisambiguatedPaths() <https://mongodb.github.io/mongo-java-driver/4.8/apidocs/mongodb-driver-core/com/mongodb/client/model/changestream/UpdateDescription.html#getDisambiguatedPaths()>`__
   API documentation. Learn more about the ``showExpandedEvents`` setting from
-  the :manual:`Expanded Events </reference/change-events/#expanded-events>` 
+  the :manual:`Expanded Events </reference/change-events/#expanded-events>`
   server documentation.
 
 .. _version-4.7.1:
@@ -121,6 +124,11 @@ loss of your DEKs.
 What's New in 4.7
 -----------------
 
+.. warning:: Breaking Changes in v4.7
+
+   The v4.7 driver contains breaking changes. See :ref:`<java-breaking-changes-v4.7>`
+   for more information.
+
 New features of the 4.7 driver release include:
 
 - Added full support for MongoDB 6.0.
@@ -307,6 +315,11 @@ in the field names of documents:
 What's New in 4.2
 -----------------
 
+.. warning:: Breaking Changes in v4.2
+
+   The v4.2 driver contains breaking changes. See :ref:`<java-breaking-changes-v4.2>`
+   for more information.
+
 New features of the 4.2 Java driver release include:
 
 - Added Azure and GCP key stores to client-side field level encryption
@@ -316,12 +329,6 @@ New features of the 4.2 Java driver release include:
 - Added a `BsonRepresentation <https://mongodb.github.io/mongo-java-driver/4.2/apidocs/bson/org/bson/codecs/pojo/annotations/BsonRepresentation.html>`_ annotation that allows you to represent the ``ObjectId`` BSON values as a ``String`` in `POJO <https://en.wikipedia.org/wiki/Plain_old_Java_object>`_ classes
 - Added a `Filters.empty() <https://mongodb.github.io/mongo-java-driver/4.2/apidocs/mongodb-driver-core/com/mongodb/client/model/Filters.html#empty()>`_ method
 
-.. important::
-
-   There are breaking changes that may affect your application. See the
-   `Upgrading Guide <https://mongodb.github.io/mongo-java-driver/4.2/upgrading/>`_
-   for more information.
-
 .. _version-4.1:
 
 What's New in 4.1
@@ -340,4 +347,9 @@ New features of the 4.1 Java driver release include:
 What's New in 4.0
 -----------------
 
+.. warning:: Breaking Changes in v4.0
+
+   The v4.0 driver contains breaking changes. See :ref:`<java-breaking-changes-v4.0>`
+   for more information.
+
 This release adds no new features.