Address review

Author: NoahStapp

bson/decimal128.py

@@ -64,8 +64,9 @@
 class DecimalEncoder(TypeEncoder):
     """Converts Python :class:`decimal.Decimal` to BSON :class:`Decimal128`.
 
-    .. warning:: When converting BSON data types to and from built-in data types,
-       the possibility of data loss is always present due to mismatches in underlying implementations.
+    For example::
+        opts = CodecOptions(type_registry=TypeRegistry([DecimalEncoder()]))
+        bson.encode({"d": decimal.Decimal('1.0')}, codec_options=opts)
 
     .. versionadded:: 4.15"""
 
@@ -80,8 +81,9 @@ def transform_python(self, value: Any) -> Decimal128:
 class DecimalDecoder(TypeDecoder):
     """Converts BSON :class:`Decimal128` to Python :class:`decimal.Decimal`.
 
-    .. warning:: When converting BSON data types to and from built-in data types,
-       the possibility of data loss is always present due to mismatches in underlying implementations.
+    For example::
+        opts = CodecOptions(type_registry=TypeRegistry([DecimalDecoder()]))
+        bson.decode(b'\x18\x00\x00\x00\x13d\x00\n\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00>0\x00', codec_options=opts)
 
     .. versionadded:: 4.15"""
 

doc/changelog.rst

@@ -2,9 +2,6 @@ Changelog
 =========
 Changes in Version 4.15.0 (XXXX/XX/XX)
 --------------------------------------
-.. warning:: When converting BSON data types to and from built-in data types, the possibility of data loss is always present
- due to mismatches in underlying implementations.
-
 PyMongo 4.15 brings a number of changes including:
 
 - Added :class:`bson.decimal128.DecimalEncoder` and :class:`bson.decimal128.DecimalDecoder`