tweak

Author: rachel-mack

source/upgrade.txt

@@ -61,6 +61,8 @@ the version after v4.0 including any listed under v4.5.
 Version 5.0 Breaking Changes
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
+This driver version introduces the following breaking changes:
+
 - Introduces the following changes to the ``ConnectionId`` class:
 
   - The ``ConnectionId`` constructor now accepts a value of type ``long`` as its second
@@ -78,15 +80,6 @@ Version 5.0 Breaking Changes
     compatibility, update any source code that uses these methods and rebuild
     your binary.
 
-- Changes the data type of the timeout duration parameter in the
-  ``SocketSettings.Builder.connectTimeout()`` and ``SocketSettings.Builder.readTimeout()``
-  methods. The data type of this parameter is now ``long`` instead of ``int``.
-  To view an
-  example that shows how to instantiate a ``SocketSettings`` instance by using
-  these methods, see the :ref:`SocketSettings Example
-  <java-socketsettings-example>` in the Specify MongoClient Settings
-  guide.
-
 - The following record annotations from the
   ``org.bson.codecs.record.annotations`` package are replaced with
   annotations of the same name from the ``org.bson.codecs.pojo.annotations`` package:
@@ -95,17 +88,16 @@ Version 5.0 Breaking Changes
   - ``BsonProperty``
   - ``BsonRepresentation``
 
-- You must pass a timeout duration, which is the first parameter, to the
-  following ``SocketSettings`` builder methods as a ``long`` type:
-
-  - ``connectTimeout()``
-  - ``readTimeout()``
-
+- Changes the data type of the timeout duration parameter in the
+  ``SocketSettings.Builder.connectTimeout()`` and
+  ``SocketSettings.Builder.readTimeout()`` methods. The data type of this
+  parameter is now ``long`` instead of ``int``.
+  
   In earlier versions, this parameter is of type ``int`` for both methods. This
   change breaks binary compatibility and requires recompiling, but does not
   require code changes. To view an example that shows how to call
   ``SocketSettings`` methods, see the :ref:`SocketSettings Example
-  <java-socketsettings-example>` in the Specify MongoClient Settings guide.  
+  <java-socketsettings-example>` in the Specify MongoClient Settings guide.
 
 - Removes the ``Filters.eqFull()`` method, released
   exclusively in ``Beta``, which allowed you