DOCSP-44196 - NaN/Infinity serialization exception (#251)

source/fundamentals/serialization/poco.txt

@@ -87,7 +87,6 @@ attributes change the way that the driver serializes each property of
 your POCO. This section describes some of the common
 serialization-related attributes.
 
-
 Serialize Read-Only Properties
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
@@ -195,6 +194,12 @@ For more information on valid type conversions, see the `{+language+}
 Conversions Specification
 <https://learn.microsoft.com/en-us/dotnet/csharp/language-reference/language-specification/conversions>`__.
 
+.. important:: Serializing NaN and Infinity
+
+   If you try to serialize or deserialize a floating-point
+   ``Infinity`` or ``NaN`` value to an integral representation, the driver throws an
+   ``OverflowException``.
+
 Set Field Order
 ~~~~~~~~~~~~~~~
 

source/upgrade/v3.txt

@@ -144,3 +144,12 @@ Version 3.0 Breaking Changes
 
 - The ``MongoClient`` constructor accepts only one ``Credential`` object instead of an
   array.
+
+- If you try to serialize or deserialize a floating-point
+  ``Infinity`` or ``NaN`` value to an integral representation, the driver throws an
+  ``OverflowException``. To learn more about floating-point ``Infinity`` and ``NaN``
+  values, see
+  `Double.NaN, <https://learn.microsoft.com/en-us/dotnet/api/system.double.nan?view=net-8.0#system-double-nan>`__
+  `Double.PositiveInfinity, <https://learn.microsoft.com/en-us/dotnet/api/system.double.positiveinfinity?view=net-8.0#system-double-positiveinfinity>`__
+  and `Double.NegativeInfinity. <https://learn.microsoft.com/en-us/dotnet/api/system.double.negativeinfinity?view=net-8.0#system-double-negativeinfinity>`__
+  on MSDN.