Fix MONGOID-5366 #upsert misuses #update_one

 (#5294)

* Fix MONGOID-5366 #upsert misuses #update_one

* add release notes documentation

Co-authored-by: Oleg Pudeyev <[email protected]>

Author: p-mongo

source/release-notes/mongoid-7.4.txt

@@ -572,3 +572,11 @@ inside a hash. For example:
 
   In Mongoid 8.0, the default value of the ``Mongoid.legacy_pluck_distinct`` option will
   change to ``false``.
+
+
+``update_one`` Warnings in ``upsert``
+-------------------------------------
+
+Mongoid 7.4.1 fixes incorrect usage of the driver's ``update_one`` method from
+Mongoid's ``upsert`` method. Mongoid's ``upsert`` actually performs a
+replacing upsert, and Mongoid 7.4.1 and later correctly call ``replace_one``.

source/release-notes/mongoid-7.5.txt

@@ -80,3 +80,10 @@ The following functions are affected by this change:
    the selector can be strings or symbols, depending on what was passed to the
    operator.
 
+
+``update_one`` Warnings in ``upsert``
+-------------------------------------
+
+Mongoid 7.5 fixes incorrect usage of the driver's ``update_one`` method from
+Mongoid's ``upsert`` method. Mongoid's ``upsert`` actually performs a
+replacing upsert, and Mongoid 7.5 correctly calls ``replace_one``.