From a2207f5fbb78e3b46c38c1e826bc632cf962f5c9 Mon Sep 17 00:00:00 2001 From: Mike Woofter <108414937+mongoKart@users.noreply.github.com> Date: Wed, 11 Sep 2024 15:02:57 -0500 Subject: [PATCH 1/5] first draft --- source/fundamentals/authentication.txt | 7 ------- source/upgrade.txt | 20 ++++++++++++++++++-- source/whats-new.txt | 2 +- 3 files changed, 19 insertions(+), 10 deletions(-) diff --git a/source/fundamentals/authentication.txt b/source/fundamentals/authentication.txt index 5ab13367..6152db22 100644 --- a/source/fundamentals/authentication.txt +++ b/source/fundamentals/authentication.txt @@ -74,13 +74,6 @@ authentication mechanisms, depending on which MongoDB versions your server suppo - ``SCRAM-SHA-256`` - ``SCRAM-SHA-1`` -- ``MONGODB-CR`` - -.. note:: - - MongoDB version 4.0 uses SCRAM as the default mechanism, and no longer - supports ``MONGODB-CR``. - Select the :guilabel:`Connection String` or :guilabel:`MongoCredential` tab to see the corresponding syntax for specifying the default authentication mechanism: diff --git a/source/upgrade.txt b/source/upgrade.txt index 2e23c01f..1210fe4c 100644 --- a/source/upgrade.txt +++ b/source/upgrade.txt @@ -17,7 +17,6 @@ Upgrade Driver Versions :depth: 1 :class: singlecol - Overview -------- @@ -57,6 +56,16 @@ changes between the current and upgrade versions. For example, if you are upgrading the driver from v2.0 to v2.20, address all breaking changes from the version after v2.0 including any listed under v2.20. +.. _csharp-breaking-changes-3.0: + +Version 3.0 Potential Breaking Change +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +- This version of the driver removes support for the + ``MONGODB-CR`` authentication mechanism. To learn more about + configuring authentication in the {+driver-short+}, see + :ref:`Authentication Mechanisms. ` + .. _csharp-breaking-changes-2.28.0: Version 2.28.0 Potential Breaking Change @@ -174,6 +183,13 @@ To learn more about the compatibility between .NET/C# driver versions and {+mdb-server+} versions, visit the :ref:`Compatibility ` page. +Version 3.0 Release Support Changes +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +The v3.0 driver drops support for {+mdb-server+} v3.6 and earlier. To +use driver v3.0 or later, your {+mdb-server+} must be v4.0 or +later. + Version 2.14 Release Support Changes ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ @@ -182,4 +198,4 @@ use any driver from v2.14 and later, your {+mdb-server+} must be v3.6 or later. To learn how to upgrade your {+mdb-server+} deployment, see -:manual:`Release Notes ` in the {+mdb-server+} manual. \ No newline at end of file +:manual:`Release Notes ` in the {+mdb-server+} manual. diff --git a/source/whats-new.txt b/source/whats-new.txt index e610704b..d9b1d6af 100644 --- a/source/whats-new.txt +++ b/source/whats-new.txt @@ -15,7 +15,7 @@ What's New :values: reference .. meta:: - :keywords: update, new feature, deprecation, upgrade, driver v2.19, driver v2.20, driver v2.21, driver v2.22, driver v2.23, driver v2.24, driver v2.25, driver v2.26 + :keywords: update, new feature, deprecation, upgrade, driver v2.19, driver v2.20, driver v2.21, driver v2.22, driver v2.23, driver v2.24, driver v2.25, driver v2.26, driver v2.27, driver v2.28, driver v3.0 Learn what's new in: From 1c87070eadd218e11b6f6a15adc9b90cae94a6e4 Mon Sep 17 00:00:00 2001 From: Mike Woofter <108414937+mongoKart@users.noreply.github.com> Date: Wed, 11 Sep 2024 15:11:09 -0500 Subject: [PATCH 2/5] wip --- source/upgrade.txt | 2 +- source/whats-new.txt | 10 ++++++++++ 2 files changed, 11 insertions(+), 1 deletion(-) diff --git a/source/upgrade.txt b/source/upgrade.txt index 1210fe4c..65663444 100644 --- a/source/upgrade.txt +++ b/source/upgrade.txt @@ -64,7 +64,7 @@ Version 3.0 Potential Breaking Change - This version of the driver removes support for the ``MONGODB-CR`` authentication mechanism. To learn more about configuring authentication in the {+driver-short+}, see - :ref:`Authentication Mechanisms. ` + :ref:`Authentication Mechanisms. ` .. _csharp-breaking-changes-2.28.0: diff --git a/source/whats-new.txt b/source/whats-new.txt index d9b1d6af..956aa338 100644 --- a/source/whats-new.txt +++ b/source/whats-new.txt @@ -32,6 +32,16 @@ Learn what's new in: .. _upcoming-breaking-changes: +.. _csharp-version-3.0: + +What's New in 3.0 +----------------- + +.. warning:: Breaking Changes in v3.0 + + The v3.0 driver contains breaking changes. See :ref:`` + for more information. + .. _csharp-version-2.28: What's New in 2.28 From 220c3352ece75d128ed9cd08193dc5be861c4baf Mon Sep 17 00:00:00 2001 From: Mike Woofter <108414937+mongoKart@users.noreply.github.com> Date: Wed, 11 Sep 2024 15:42:37 -0500 Subject: [PATCH 3/5] compat --- .../language-compatibility-table-csharp.rst | 8 ++++++++ .../mongodb-compatibility-table-csharp.rst | 14 ++++++++++++++ 2 files changed, 22 insertions(+) diff --git a/source/includes/language-compatibility-table-csharp.rst b/source/includes/language-compatibility-table-csharp.rst index 66837d2e..bb29ab09 100644 --- a/source/includes/language-compatibility-table-csharp.rst +++ b/source/includes/language-compatibility-table-csharp.rst @@ -14,6 +14,14 @@ - .NET Core 3.X - .NET Core 2.X + * - 3.0 + - ✓ + - ✓ + - ✓ + - ✓ + - ✓ + - ✓ + * - 2.3 to 2.28 - ✓ - ✓ diff --git a/source/includes/mongodb-compatibility-table-csharp.rst b/source/includes/mongodb-compatibility-table-csharp.rst index b46b72fc..5e5fec99 100644 --- a/source/includes/mongodb-compatibility-table-csharp.rst +++ b/source/includes/mongodb-compatibility-table-csharp.rst @@ -17,6 +17,20 @@ - MongoDB 3.0 - MongoDB 2.6 + * - 3.0 + - ✓ + - ✓ + - ✓ + - ✓ + - ✓ + - ✓ + - ✓ + - + - + - + - + - + * - 2.29 - ✓ - ✓ From 4dc3955edc315dca0fc5e835a484add41fe88329 Mon Sep 17 00:00:00 2001 From: Mike Woofter <108414937+mongoKart@users.noreply.github.com> Date: Wed, 11 Sep 2024 16:00:02 -0500 Subject: [PATCH 4/5] compat --- source/includes/language-compatibility-table-csharp.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/source/includes/language-compatibility-table-csharp.rst b/source/includes/language-compatibility-table-csharp.rst index bb29ab09..acec5bea 100644 --- a/source/includes/language-compatibility-table-csharp.rst +++ b/source/includes/language-compatibility-table-csharp.rst @@ -20,7 +20,7 @@ - ✓ - ✓ - ✓ - - ✓ + - * - 2.3 to 2.28 - ✓ @@ -45,7 +45,7 @@ - .NET 4.7 [#2.14-note]_ - .NET 4.6 - * - 2.13 to 2.28 + * - 2.13 to 3.0 - ✓ - ✓ - From 6e6624c76797f9faf80ac41b8f1702ee9911f043 Mon Sep 17 00:00:00 2001 From: Mike Woofter <108414937+mongoKart@users.noreply.github.com> Date: Thu, 12 Sep 2024 08:10:54 -0500 Subject: [PATCH 5/5] add link --- source/whats-new.txt | 1 + 1 file changed, 1 insertion(+) diff --git a/source/whats-new.txt b/source/whats-new.txt index 956aa338..e17e8345 100644 --- a/source/whats-new.txt +++ b/source/whats-new.txt @@ -19,6 +19,7 @@ What's New Learn what's new in: +* :ref:`Version 3.0 ` * :ref:`Version 2.28 ` * :ref:`Version 2.27 ` * :ref:`Version 2.26 `