DOCS-14662 mod match expression values (mongodb#6022)

DOCS-14662 mod match expression values

Co-authored-by: jason-price-mongodb <[email protected]>

Author: jason-price-mongodb

source/reference/operator/query/mod.txt

@@ -21,20 +21,22 @@ $mod
 
       { field: { $mod: [ divisor, remainder ] } }
 
+.. _mod-behavior:
+
 Behavior
 --------
 
-The :query:`$mod` operator returns an error if the:
-
-- ``[ divisor, remainder ]`` array contains fewer or more than
-  two elements. For examples, see :ref:`mod-not-enough-elements` and
-  :ref:`mod-too-many-elements` respectively.
+The :query:`$mod` operator returns an error if the  ``[ divisor,
+remainder ]`` array contains fewer or more than two elements. For
+examples, see :ref:`mod-not-enough-elements` and
+:ref:`mod-too-many-elements` respectively.
 
-- ``divisor`` or ``remainder`` values evaluate to:
+Also, starting in MongoDB 5.1 (and 5.0.4 and 4.4.10), :query:`$mod`
+returns an error if the ``divisor`` or ``remainder`` values evaluate to:
 
-  - ``NaN`` (not a number) or ``Infinity``.
+- ``NaN`` (not a number) or ``Infinity``.
 
-  - A value that cannot be represented using a 64-bit integer.
+- A value that cannot be represented using a 64-bit integer.
 
 Examples
 --------

source/release-notes/5.0-compatibility.txt

@@ -386,6 +386,13 @@ Starting in MongoDB 5.0:
   ``Double()`` constructor with the :dbcommand:`replSetResizeOplog`
   command.
 
+``$mod`` Error Behavior
+~~~~~~~~~~~~~~~~~~~~~~~
+
+Starting in MongoDB 5.0.4 (and 4.4.10), the :query:`$mod`
+operator returns an error if the ``divisor`` or ``remainder`` values
+evaluate to certain values. See :ref:`$mod behavior <mod-behavior>`.
+
 Deprecations
 ~~~~~~~~~~~~