Merge branch 'master' into docsp-44476-remove-methods

Author: mongoKart

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

@@ -21,13 +21,25 @@ jobs:
               files: source/**
           - name: Build Netlify Links for Changed Pages
             id: build_page_links
+            env:
+                CHANGED_FILES: ${{ steps.changed-files.outputs.all_changed_files }}
             run: |
+              # Function to validate file paths
+              validate_file_path() {
+                local file_path="$1"
+                # Allow only alphanumeric characters, _ . / and -
+                if [[ ! "$file_path" =~ ^[a-zA-Z0-9._/-]+$ ]]; then
+                  echo "Invalid file path detected: $file_path" >&2
+                  exit 1
+                fi
+              }
+              
               new_links=""
               base_link='https://deploy-preview-${{ github.event.number }}--mongodb-docs-csharp.netlify.app'
-              changed_files=${{ steps.changed-files.outputs.all_changed_files }}
-              files=$(echo $changed_files | tr "," "\n")
+              files=$(echo "$CHANGED_FILES" | tr "," "\n")
               for file in $files; do
                 echo "processing ${file}"
+                validate_file_path "$file"
                 if (! grep -s "includes/"  <<< $file) && 
                     (! grep -s "images/"  <<< $file) && 
                     (! grep -s "examples/"  <<< $file); then

config/redirects

@@ -1,6 +1,6 @@
 define: prefix docs/drivers/csharp
 define: base https://www.mongodb.com/${prefix}
-define: versions v2.19 v2.20 v2.21 v2.22 v2.23 v2.24 v2.25 v2.26 v2.27 v2.28 v2.29 v2.30 master
+define: versions v2.19 v2.20 v2.21 v2.22 v2.23 v2.24 v2.25 v2.26 v2.27 v2.28 v2.29 v2.30 v3.0 master
 
 symlink: current -> master
 
@@ -14,3 +14,5 @@ raw: ${prefix}/master -> ${base}/upcoming/
 [*-master]: ${prefix}/${version}/fundamentals/data-formats/polymorphism/ -> ${base}/${version}/fundamentals/serialization/polymorphic-objects/
 [*-master]: ${prefix}/${version}/fundamentals/data-formats/bson/ -> ${base}/${version}/fundamentals/bson/
 [*-master]: ${prefix}/${version}/fundamentals/class-mapping/ -> ${base}/${version}/fundamentals/serialization/class-mapping/
+[*-v2.30]: ${prefix}/${version}/upgrade/v2/ -> ${base}/${version}/upgrade/
+[*-v2.30]: ${prefix}/${version}/upgrade/v3/ -> ${base}/${version}/upgrade/

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

@@ -66,6 +66,11 @@ Version 3.0 Breaking Changes
   provides a replacement for a deprecated class, method, or property, the compiler
   messages in v{+last-version-2-number+} will display it.
 
+- The methods, properties, and constructors in the ``MongoDB.Bson`` namespace that were
+  deprecated in previous versions of the driver have been removed. If the driver
+  provides a replacement for a deprecated method, property, or constructor, the compiler
+  messages in v{+last-version-2-number+} will display it.
+
 - The driver drops support for the
   ``MONGODB-CR`` authentication mechanism. To learn more about
   configuring authentication in the {+driver-short+}, see
@@ -145,6 +150,11 @@ 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``