MONGOID-5273 Improvements/fixes to 7.4 release notes (#5247)

Co-authored-by: shields <[email protected]>

Author: p-mongo

source/release-notes/mongoid-7.4.txt

@@ -134,12 +134,12 @@ and matches the core Ruby behavior:
 
 .. note::
 
-  The value of ``Mongoid.legacy_triple_equals`` option will change to ``false``
-  by default in Mongoid 8.0.
+  In Mongoid 8.0, the default value of the ``Mongoid.legacy_triple_equals`` option will
+  change to ``false``.
 
 
-Return Hexadecimal ``_id`` Value from ``BSON::ObjectId#as_json``
-----------------------------------------------------------------
+Return String ``_id`` Value (Hexadecimal) from ``BSON::ObjectId#as_json``
+-------------------------------------------------------------------------
 
 Mongoid 7.4 permits configuring the ``BSON::ObjectId#as_json`` method
 to return the ``_id`` value as a hexadecimal string instead of the
@@ -176,6 +176,11 @@ The behavior of ``as_json`` is summarized in the following table:
      - ``{"$oid"=>"621ed7fda15d5d231594627c"}``
      - ``"621ed7fda15d5d231594627c"``
 
+.. note::
+
+  In Mongoid 8.0, the default value of the ``Mongoid.object_id_as_json_oid`` option will
+  change to ``false``.
+
 
 Scoped Associations
 -------------------
@@ -203,8 +208,12 @@ that are already loaded into memory vs queries on unloaded associations and
 top-level models.
 
 The ``Mongoid.compare_time_by_ms`` option is set to ``false`` by default
-in Mongoid 7.4 for backwards compatibility. In Mongoid 8 the default value
-will change to ``true``.
+in Mongoid 7.4 for backwards compatibility.
+
+.. note::
+
+  In Mongoid 8.0, the default value of the ``Mongoid.compare_time_by_ms`` option will
+  change to ``true``.
 
 
 ``count``, ``sum``, ``avg``, ``min``, ``max`` Ignore Sort If Not Limiting/Skipping
@@ -237,8 +246,8 @@ set to ``true`` (the default) returns ``nil`` in this case.
 
 .. note::
 
-  The value of ``Mongoid.broken_aggregables`` option will change to ``false``
-  by default in Mongoid 8.0.
+  In Mongoid 8.0, the default value of the ``Mongoid.broken_aggregables`` option will
+  change to ``false``.
 
 
 Correct Update Behavior When Replacing Association
@@ -266,8 +275,8 @@ we would expect it to be ``palette``.
 
 .. note::
 
-  The value of ``Mongoid.broken_update`` option will change to ``false``
-  by default in Mongoid 8.0.
+  In Mongoid 8.0, the default value of the ``Mongoid.broken_updates`` option will
+  change to ``false``
 
 
 Correct Logical ``and`` Query Generation
@@ -307,8 +316,8 @@ generated instead which omit the {"$in" => [2021]} condition:
 
 .. note::
 
-  The value of ``Mongoid.broken_and`` option will change to ``false``
-  by default in Mongoid 8.0.
+  In Mongoid 8.0, the default value of the ``Mongoid.broken_and`` option will
+  change to ``false``.
 
 
 Restore Parent Scope When Exiting ``with_scope`` Block
@@ -344,8 +353,8 @@ all scopes are cleared:
 
 .. note::
 
-  The value of ``Mongoid.broken_scoping`` option will change to ``false``
-  by default in Mongoid 8.0.
+  In Mongoid 8.0, the default value of the ``Mongoid.broken_scoping`` option will
+  change to ``false``.
 
 
 Changes to ``distinct`` and ``pluck``
@@ -396,8 +405,8 @@ Mongoid 7.3 and 7.4 with ``Mongoid.broken_alias_handling`` set to ``true`` behav
 
 .. note::
 
-  The value of ``Mongoid.broken_alias_handling`` option will change to ``false``
-  by default in Mongoid 8.0.
+  In Mongoid 8.0, the default value of the ``Mongoid.broken_alias_handling`` option will
+  change to ``false``.
 
 
 Demongoize Values Returned from ``pluck`` and ``distinct``
@@ -441,8 +450,9 @@ distinct methods will not be demongoized. For example:
 
 .. note::
 
-  The value of ``Mongoid.legacy_pluck_distinct`` option will change to ``false``
-  by default in Mongoid 8.0.
+  In Mongoid 8.0, the default value of the ``Mongoid.legacy_pluck_distinct`` option will
+  change to ``false``.
+
 
 Localized Fields with ``pluck`` and ``distinct``
 ````````````````````````````````````````````````
@@ -489,8 +499,8 @@ For example:
 
 .. note::
 
-  The value of ``Mongoid.legacy_pluck_distinct`` option will change to ``false``
-  by default in Mongoid 8.0.
+  In Mongoid 8.0, the default value of the ``Mongoid.legacy_pluck_distinct`` option will
+  change to ``false``.
 
 
 Embedded Fields with ``pluck``
@@ -532,6 +542,5 @@ inside a hash. For example:
 
 .. note::
 
-  The value of ``Mongoid.legacy_pluck_distinct`` option will change to ``false``
-  by default in Mongoid 8.0.
-
+  In Mongoid 8.0, the default value of the ``Mongoid.legacy_pluck_distinct`` option will
+  change to ``false``.