first draft

Author: mongoKart

source/upgrade/v3.txt

@@ -152,4 +152,16 @@ Version 3.0 Breaking Changes
   `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.
+  on MSDN.
+
+- The driver includes the following changes to the ``BsonValue`` class:
+
+  - Removes the ``[Obsolete]`` attribute from the ``AsLocalTime()`` and
+    ``AsUniversalTime()`` methods.
+  - Adds the `AsNullableLocalTime() <{+new-api-root+}/MongoDB.Bson/MongoDB.Bson.BsonValue.AsNullableLocalTime.html#MongoDB_Bson_BsonValue_AsNullableLocalTime>`__
+    and `AsNullableUniversalTime() <{+new-api-root+}/MongoDB.Bson/MongoDB.Bson.BsonValue.AsNullableUniversalTime.html#MongoDB_Bson_BsonValue_AsNullableUniversalTime>`__
+    methods.
+  - Removes the ``AsDateTime()`` method. Use the `AsUniversalTime() <{+new-api-root+}/MongoDB.Bson/MongoDB.Bson.BsonValue.AsUniversalTime.html#MongoDB_Bson_BsonValue_AsUniversalTime>`__
+    method instead. 
+  - Removes the ``AsNullableDateTime()`` method. Use the `AsNullableUniversalTime() <{+new-api-root+}/MongoDB.Bson/MongoDB.Bson.BsonValue.AsNullableUniversalTime.html#MongoDB_Bson_BsonValue_AsNullableUniversalTime>`__
+    method instead.