Merge branch 'master' into secbug-304-rce

Author: mongoKart

.github/workflows/add-netlify-links.yml

@@ -55,4 +55,4 @@ jobs:
           appendContentOnMatchOnly: true
           regexFlags: is
           content: "<!-- start insert-links -->\n${{ steps.build_page_links.outputs.staging_links }}\n<!-- end insert-links -->"
-          token: ${{ secrets.GITHUB_TOKEN }}
+          token: ${{ secrets.GITHUB_TOKEN }}

source/fundamentals/authentication.txt

@@ -153,12 +153,26 @@ MONGODB-AWS
    The ``MONGODB-AWS`` authentication mechanism is available only for
    MongoDB deployments on MongoDB Atlas.
 
-The ``MONGODB-AWS`` authentication mechanism uses your Amazon Web Services
-Identity and Access Management (AWS IAM) credentials to authenticate your
-user. You can either specify your credentials explicitly
-or instruct the driver to retrieve them automatically from an external source.
+The ``MONGODB-AWS`` authentication mechanism uses Amazon Web Services
+Identity and Access Management (AWS IAM) credentials to authenticate a user to MongoDB.
 
-The following sections contain code examples that use the following placeholders:
+To use AWS authentication, first perform the following steps:
+
+- Add the `MongoDB.Driver.Authentication.AWS <https://www.nuget.org/packages/MongoDB.Driver.Authentication.AWS>`__
+  NuGet package to your project.
+- Add the following line of code to your application's bootstrap code to register the
+  AWS authentication provider:
+
+  .. code-block:: csharp
+     :copyable: true
+
+     MongoClientSettings.Extensions.AddAWSAuthentication();
+
+After you register the AWS authentication provider, you can either specify the AWS IAM 
+credentials explicitly or instruct the driver to retrieve them automatically from an
+external source. The following sections describe both of these methods.
+ 
+The code examples in these sections use the following placeholders:
 
 - ``<awsKeyId>`` - value of the AWS access key ID
 - ``<awsSecretKey>`` - value of the AWS secret access key

source/upgrade/v3.txt

@@ -150,11 +150,28 @@ Version 3.0 Breaking Changes
 - The ``MongoClient`` constructor accepts only one ``Credential`` object instead of an
   array.
 
+- To use Amazon Web Services (AWS) authentication, you must add the
+  ``MongoDB.Driver.Authentication.AWS`` package to your project and register the
+  authentication provider in your application's bootstrap code. To learn more about
+  using AWS authentication with the {+driver-short+}, see :ref:`csharp-mongodb-aws`.
+
 - 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.
+  on MSDN.
+
+- The driver includes the following changes to the ``BsonValue`` class:
+
+  - Removes the ``[Obsolete]`` attribute from the ``AsLocalTime`` and
+    ``AsUniversalTime`` properties.
+  - 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>`__
+    properties.
+  - Removes the ``AsDateTime`` property. Use the `AsUniversalTime <{+new-api-root+}/MongoDB.Bson/MongoDB.Bson.BsonValue.AsUniversalTime.html#MongoDB_Bson_BsonValue_AsUniversalTime>`__
+    property instead. 
+  - Removes the ``AsNullableDateTime`` property. Use the `AsNullableUniversalTime <{+new-api-root+}/MongoDB.Bson/MongoDB.Bson.BsonValue.AsNullableUniversalTime.html#MongoDB_Bson_BsonValue_AsNullableUniversalTime>`__
+    property instead.