Merge branch 'v3.0' into docsp-43125-remove-logging

Author: mongoKart

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

@@ -0,0 +1,56 @@
+name: Add Netlify Links To Changed Pages
+on:
+    workflow_call:
+    pull_request_target:
+jobs:
+    get-pr-changes:
+        name: Get Changed Files & Update PR Description
+        runs-on: ubuntu-latest
+        permissions:
+            issues: write
+            contents: write
+            pull-requests: write
+            repository-projects: write
+        steps:
+          - uses: actions/checkout@v4
+          - name: Get Changed Files
+            id: changed-files
+            uses: tj-actions/changed-files@v44
+            with:
+              separator: ","
+              files: source/**
+          - name: Build Netlify Links for Changed Pages
+            id: build_page_links
+            run: |
+              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")
+              for file in $files; do
+                echo "processing ${file}"
+                if (! grep -s "includes/"  <<< $file) && 
+                    (! grep -s "images/"  <<< $file) && 
+                    (! grep -s "examples/"  <<< $file); then
+                  file="${file#source}"
+                  file="${file%.txt}"
+                  filenoslash="${file:1}"
+                  echo "${base_link}${file}"
+                  new_links+="<li><a href=${base_link}${file}>${filenoslash}</a></li>"
+                else
+                  echo "(file skipped)"
+                fi
+              done
+              if [ "$new_links" == "" ]; then
+                new_links="No pages to preview"
+              fi
+              echo "Final new_links string: "
+              echo "${new_links}"
+              echo "staging_links=${new_links}" >> "$GITHUB_OUTPUT"
+          - name: Update the PR Description
+            uses: MongoCaleb/pr-description-action@master
+            with:
+                regex: "<!-- start insert-links -->.*<!-- end insert-links -->"
+                appendContentOnMatchOnly: true
+                regexFlags: is
+                content: "<!-- start insert-links -->\n${{ steps.build_page_links.outputs.staging_links }}\n<!-- end insert-links -->"
+                token: ${{ secrets.GITHUB_TOKEN }}

.github/workflows/copy-compat-to-docs-shared.yml

@@ -7,6 +7,7 @@ on:
     paths:
       - "source/includes/mongodb-compatibility-table-csharp.rst"
       - "source/includes/language-compatibility-table-csharp.rst"
+  workflow_dispatch:
 
 jobs:
   copy-file:

source/faq.txt

@@ -215,11 +215,7 @@ If you receive an ``Unsupported filter ...`` or ``Expression not
 supported ...`` exception message, try the following
 steps:
 
-1. Try configuring the new `LINQ3
-   <https://mongodb.github.io/mongo-csharp-driver/2.17/reference/driver/crud/linq3/>`__
-   provider. The LINQ3 provider contains many fixes and new features
-   over the LINQ2 provider.
-#. Use the `{+analyzer+}
+1. Use the `{+analyzer+}
    <https://www.mongodb.com/docs/mongodb-analyzer/current/>`__ to analyze your
    expressions.
 #. Try to simplify your query where possible.

source/fundamentals/connection/connection-options.txt

@@ -198,13 +198,6 @@ relevant options.
        | **Default**: ``false``
        | **Connection URI Example**: {+not-available+}
 
-   * - **LinqProvider**
-     - | The LINQ provider to use.
-       |
-       | **Data Type**: `LinqProvider <{+new-api-root+}/MongoDB.Driver/MongoDB.Driver.Linq.LinqProvider.html>`__
-       | **Default**: ``LinqProvider.V3``
-       | **Connection URI Example**: {+not-available+}
-
    * - **LoadBalanced**
      - | Specifies whether the driver is connecting to a load balancer. You can set this
        | property to ``true`` only if:

source/fundamentals/linq.txt

@@ -28,6 +28,11 @@ strongly typed collections of objects by using language keywords and operators.
 The {+driver-short+} automatically translates LINQ queries into
 :manual:`aggregation operations </aggregation>`.
 
+.. important:: 
+
+   LINQ3 is the only LINQ provider available in the {+driver-long+}. If you have
+   manually configured your project to use LINQ2, it will not compile.
+
 The examples in this guide use the ``restaurants`` collection
 in the ``sample_restaurants`` database provided in the :atlas:`Atlas sample datasets </sample-data>`.
 To learn how to create a free MongoDB Atlas cluster and load the sample datasets,

source/upgrade.txt

@@ -69,6 +69,9 @@ Version 3.0 Potential Breaking Change
 - This version removes the ``ClusterBuilder.ConfigureSdamLogging()`` method.
   To configure logging in your application, see the :ref:`csharp-logging` guide.
 
+- The LINQ2 provider has been removed from this version of the driver.
+  You must use LINQ3 for all LINQ queries.
+
 .. _csharp-breaking-changes-2.28.0:
 
 Version 2.28.0 Potential Breaking Change

source/whats-new.txt

@@ -43,6 +43,13 @@ What's New in 3.0
    The v3.0 driver contains breaking changes. See :ref:`<csharp-breaking-changes-3.0>`
    for more information.
 
+The 3.0 driver release includes the following new features:
+
+- Removes the
+  `mongocsharpdriver <https://www.nuget.org/packages/mongocsharpdriver/#readme-body-tab>`__ NuGet package,
+  which implements the v1.x driver API in driver versions 2.x. This package will no
+  longer receive updates.
+
 .. _csharp-version-2.28:
 
 What's New in 2.28