stincmale feedback

Author: mongoKart

source/upgrade.txt

@@ -159,11 +159,12 @@ Version 5.0 Breaking Changes
   ``$collStats`` aggregation pipeline stage. For an example of how to use this pipeline
   stage, see :manual:`What's New <java-deprecations-4.11>` for v4.11 of the {+driver-short+}.
 
-- Removes the ``IterableCodec`` and ``MapCodec`` types.
-  Use ``MapCodecProvider`` instead of ``MapCodec``, and ``CollectionCodecProvider``
-  instead of ``IterableCodec``.
+- The ``MapCodec`` and ``IterableCodec`` classes are deprecated.
+   Instead of ``MapCodec``, use ``MapCodecProvider``. Instead of ``IterableCodec``,
+   use ``CollectionCodecProvider``, or ``IterableCodecProvider`` for ``Iterable``
+   types that aren't ``Collection``s.  
 
-- Removes the ``sharded`` and ``nonAtomic`` options from the
+- Removes the ``sharded()`` and ``nonAtomic()`` methods from the
   ``MapReducePublisher`` and ``MapReduceIterable`` classes.
 
 - Removes the following methods for use with ``geoHaystack`` indexes:
@@ -197,7 +198,7 @@ Version 5.0 Breaking Changes
 
   - ``acknowledged(Type, int, List<BulkWriteUpsert>)``
   - ``acknowledged(Type, int, Integer, List<BulkWriteUpsert>)``
-  - ``acknowledged(int, int, int, Integer, List<BulkWriteUpsert>)<String>)``
+  - ``acknowledged(int, int, int, Integer, List<BulkWriteUpsert>)``
 
 - Removes the following ``ChangeStreamDocument`` constructors:
 
@@ -229,15 +230,8 @@ Version 5.0 Breaking Changes
 - Removes the ``errorLabels`` option from the ``WriteConcernError``
   class. This includes the ``addLabel()`` and ``getErrorLabels()`` methods and the
   constructor that includes an ``errorLabels`` parameter. Instead, you can use
-  the error labels included in the top-level response document.
-
-- Removes the
-  ``org.mongodb.scala.ObservableImplicits.ToSingleObservableVoid`` implicit
-  class from the Scala driver package. This means the
-  ``org.reactivestreams.Publisher[Void]`` type no longer
-  converts automatically to ``org.mongodb.scala.SingleObservable[Void]``. The
-  API also exposes ``org.mongodb.scala.Observable[Unit]`` instead of
-  ``org.mongodb.scala.Observable[Void]``. 
+  the error labels included in the ``MongoException`` object that contains the
+  ``WriteConcernError``.
 
 - Introduces the following changes to the ``ConnectionId`` class:
 

source/whats-new.txt

@@ -285,9 +285,10 @@ What's New in 4.8
 
 .. important:: Deprecation Notice
 
-   The ``IterableCodec`` and ``MapCodec`` classes are deprecated.
-   Use ``MapCodecProvider`` instead of ``MapCodec`` and ``CollectionCodecProvider``
-   instead of ``IterableCodec``.
+   The ``MapCodec`` and ``IterableCodec`` classes are deprecated.
+   Instead of ``MapCodec``, use ``MapCodecProvider``. Instead of ``IterableCodec``,
+   use ``CollectionCodecProvider``, or ``IterableCodecProvider`` for ``Iterable``
+   types that aren't ``Collection``s.  
 
 Behavioral changes with the 4.8 driver release include: