VK review

Author: rachel-mack

source/includes/fundamentals/code-snippets/mcs.java

@@ -91,8 +91,8 @@ private static void createSocketSettings() {
             MongoClient mongoClient = MongoClients.create(
                 MongoClientSettings.builder().applyConnectionString(new ConnectionString("<your connection string>"))
                 .applyToSocketSettings(builder ->
-                    builder.connectTimeout(10L, SECONDS)
-                    .readTimeout(15L, SECONDS))
+                    builder.connectTimeout(10, SECONDS)
+                    .readTimeout(15, SECONDS))
                 .build());
             //end SocketSettings
             mongoClient.listDatabaseNames().forEach(n -> System.out.println(n));

source/upgrade.txt

@@ -92,11 +92,13 @@ Version 5.0 Breaking Changes
   - ``readTimeout()``
 
   In earlier versions, this parameter is of type ``int`` for both methods. To view an example
-  that shows how to instantiate a ``SocketSettings`` instance by using
-  these methods, see the :ref:`SocketSettings Example
+  that shows how to call ``SocketSettings`` methods, see the :ref:`SocketSettings Example
   <java-socketsettings-example>` in the Specify MongoClient Settings
   guide.
 
+  This change breaks binary compatibility (requires recompiling) but does not
+  require code changes.
+
 - This driver version removes the ``Filters.eqFull()`` method, released
   exclusively in ``Beta``, which allowed you
   to construct an equality filter when performing a vector search.

source/whats-new.txt

@@ -48,16 +48,14 @@ What's New in 5.0
 
 The 5.0 driver release introduces the following features:
 
-- Consistent computation of the ``ClusterConnectionMode`` type after
-  instantiating a ``ClusterSettings``. The connection mode defaults to
-  ``SINGLE`` if you specify one host and do not specify a replica set
-  name, or it defaults to ``MULTIPLE`` if you specify more than one
-  host.
-
-- ``BsonDecimal128`` values respond to method calls in the same way as Java
-  ``Decimal128`` values. In particular, the error responses for the
-  ``isNumber()`` and ``asNumber()`` methods match the Java responses for
-  equivalent ``Decimal128`` values.
+- ``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,