JY review

Author: rachel-mack

source/upgrade.txt

@@ -121,6 +121,17 @@ Version 5.0 Breaking Changes
   .. After the 5.0 Scala API docs are released, this line will be uncommented. 
     For more information, see the `Observable trait documentation <https://mongodb.github.io/mongo-java-driver/5.0/apidocs/mongo-scala-driver/org/mongodb/scala/Observable.html>`__.
 
+- This driver changes how ``ClusterSettings`` computes
+  ``ClusterConnectionMode``, making it more consistent by using the specified
+  replica set name, regardless of how it is configured. Previously, replica set
+  name was only considered if it was set by the connection string. This may
+  change how 
+
+- This driver changes how ``BsonDecimal128`` values respond to method calls, by
+  responding in the same way as ``Decimal128`` values. In particular,
+  ``BsonDecimal128.isNumber()`` now returns ``true``, and
+  ``BsonDecimal128.asNumber()`` returns the equivalent ``BsonNumber``.
+
 .. _java-breaking-changes-v4.8:
 
 Version 4.8 Breaking Changes

source/whats-new.txt

@@ -48,15 +48,6 @@ What's New in 5.0
 
 The 5.0 driver release introduces the following features:
 
-- ``ClusterSettings`` computes ``ClusterConnectionMode`` more consistently using
-  the specified replica set name, regardless of how it is configured.
-  Previously, replica set name was only considered if it was set by the
-  connection string.
-
-- ``BsonDecimal128`` values respond to method calls in the same way as
-  ``Decimal128`` values. In particular, ``BsonDecimal128.isNumber`` now returns
-  ``true``, and ``BsonDecimal128.asNumber`` returns the equivalent ``BsonNumber``.
-
 - The ``getElapsedTime()`` method on ``com.mongodb.event.ConnectionReadyEvent``
   includes the time taken to deliver the ``ConnectionCreatedEvent``. That is,
   the time returned includes the duration of the