DOCSP-48752 - v3.3 (#552)

Author: mongoKart

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 v3.0 v3.1 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 v3.1 v3.2 v3.3 master
 
 symlink: current -> master
 

snooty.toml

@@ -34,7 +34,7 @@ mdb-server = "MongoDB Server"
 mongo-community = "MongoDB Community Edition"
 mongo-enterprise = "MongoDB Enterprise Edition"
 docs-branch = "master"                                                                                          # always set this to the docs branch (i.e. master, 1.7, 1.8, etc.)
-version-number = "3.2"
+version-number = "3.3"
 last-version-2-number = "2.30"
 version = "v{+version-number+}"
 example = "https://raw.githubusercontent.com/mongodb/docs-csharp/{+docs-branch+}/source/includes/code-examples"

source/fundamentals/builders.txt

@@ -99,6 +99,8 @@ to a LINQ query:
    var filter = builder.Lt("Price", 20) & builder.Eq("Category", "Perennial");
    var query = collection.AsQueryable().Where(f => filter.Inject());
 
+.. _csharp-builders-array-operators:
+
 Array Operators
 ~~~~~~~~~~~~~~~
 

source/includes/language-compatibility-table-csharp.rst

@@ -14,7 +14,7 @@
      - .NET Core 3.X
      - .NET Core 2.X
 
-   * - 3.0 to 3.2
+   * - 3.0 to 3.3
      - ✓
      - ✓
      - ✓

source/includes/mongodb-compatibility-table-csharp.rst

@@ -17,7 +17,7 @@
      - MongoDB 3.0
      - MongoDB 2.6
 
-   * - 3.0 to 3.2
+   * - 3.0 to 3.3
      - ✓
      - ✓
      - ✓

source/whats-new.txt

@@ -15,7 +15,7 @@ What's New
    :values: reference
 
 .. meta::
-   :keywords: update, new feature, deprecation, upgrade, driver v2.22, driver v2.23, driver v2.24, driver v2.25, driver v2.26, driver v2.27, driver v2.28, driver v3.0
+   :keywords: update, new feature, deprecation, upgrade, driver v2.25, driver v2.26, driver v2.27, driver v2.28, driver v3.0
 
 Learn what's new in:
 
@@ -29,12 +29,17 @@ Learn what's new in:
 * :ref:`Version 2.27 <csharp-version-2.27>`
 * :ref:`Version 2.26 <csharp-version-2.26>`
 * :ref:`Version 2.25 <version-2.25>`
-* :ref:`Version 2.24 <version-2.24>`
-* :ref:`Version 2.23 <version-2.23>`
-* :ref:`Version 2.22 <version-2.22>`
 
 .. _upcoming-breaking-changes:
 
+Upcoming Breaking Changes
+-------------------------
+
+In accordance with the `MongoDB Software Lifecycle Schedules
+<https://www.mongodb.com/legal/support-policy/lifecycles>`__, an upcoming minor
+version of {+driver-short+} will raise the minimum {+mdb-server+} version from
+4.0 to 4.2. {+driver-short+} will no longer support {+mdb-server+} 4.0.
+
 .. _csharp-version-3.3:
 
 What's New in 3.3
@@ -46,6 +51,37 @@ The 3.3 driver release includes the following new features:
   ``create`` events in the ``ChangeStreamDocument`` class. To learn more
   about change streams, see the :ref:`csharp-change-streams` guide.
 
+- Adds the following In-Use Encryption features:
+
+  - Support for the :manual:`$lookup </reference/operator/aggregation/lookup/>`
+    aggregation stage
+
+  - A ``ClientEncryptionOptions`` property that configures the data-encryption
+    key cache lifetime
+
+  To learn more about In-Use Encryption, see the :ref:`In-Use Encryption <csharp-fle>` guide.
+
+- Adds the following LINQ features:
+
+  - Support for the ``SkipWhile()`` and ``TakeWhile()`` LINQ
+    aggregation methods.
+
+  - Support for the ``$sigmoid`` expression in LINQ queries.
+
+  - Support for using LINQ syntax to access any dictionary key that is
+    serialized as a string, regardless of its underlying data type.
+
+- Adds support for the ``$rankFusion`` aggregation stage, which enables rank-based
+  result scoring on combined results from multiple pipelines.
+
+- Adds support for nested :manual:`$elemMatch </reference/operator/query/elemMatch/>`
+  queries by providing an overload of the ``ElemMatch()`` method that takes only a filter
+  parameter. To learn more, see the :ref:`csharp-builders-array-operators` section of the
+  Builders guide.
+
+- Adds support for using the ``OfType<T>()`` method and ``is`` operator to check
+  the type of a scalar discriminator.
+
 .. _csharp-version-3.2:
 
 What's New in 3.2
@@ -364,66 +400,4 @@ The 2.25 driver release includes the following new features:
 - Added support for overriding the ``"mongodb"`` service name with a custom one
   by using the ``srvServiceName`` connection option.
 - Improved behavior of bulk write operations to prevent enumerating the requests
-  parameter more than once.
-
-.. _version-2.24:
-
-What's New in 2.24
-------------------
-
-The 2.24 driver release includes the following new features:
-
-- Added the `IMongoCollection.DistinctMany() <{+new-api-root+}/MongoDB.Driver/MongoDB.Driver.IMongoCollection-1.DistinctMany.html>`__ method.
-- Added support for the latest optional arguments for the :manual:`$dateFromString </reference/operator/aggregation/dateFromString/>`
-  aggregation expression.
-- Added support for sorting by score in the :manual:`$search </reference/operator/aggregation/search/>`
-  aggregation stage.
-- Added the ``VectorSearchScore`` builder for the :manual:`$vectorSearch </reference/operator/aggregation/vectorSearch/>`
-  aggregation stage.
-- Added support for the `$in <https://www.mongodb.com/docs/manual/reference/operator/query/in/>`__
-  operator in Atlas Search.
-- Added the ``Mql.Exists()``, ``Mql.IsMissing()``, and ``Mql.IsNullOrMissing()`` methods for
-  LINQ queries.
-- Added support for the ``IComparable.CompareTo()`` method in LINQ queries.
-- Added support for nested calls to the ``AsQueryable()`` method to support LINQ queries
-  by the `MongoDB Entity Framework Core Provider <https://www.mongodb.com/docs/entity-framework/current/>`__.
-- Added support for TLS 1.3.
-- Updated the ``libmongocrypt`` package version to 1.8.2.
-- Fixed a segfault in Kerberos (``libgssapi``) on newer Linux distributions.
-- Fixed a GridFS bug in which downloading a file caused an error if a larger file
-  with the same ID had also been uploaded.
-- The ``ExceededTimeLimit`` server error is now retryable for both read and write operations.
-- When running within a function-as-a-service (FaaS) environment, such as AWS Lambda,
-  the driver now uses the polling monitoring mechanism.
-- To improve MongoDB Atlas Serverless compatibility, the driver now uses OP_MSG for
-  authentication if the server supports it.
-
-.. _version-2.23:
-
-What's New in 2.23
-------------------
-
-The 2.23 driver release includes the following new features:
-
-- Improvements and bug fixes to the LINQ3 integration.
-- Added support for aggregation bitwise operators.
-- Added support for the ``$out`` operator in MongoDB time series collections.
-- Added `ChangeStreamSplitLargeEvent <https://mongodb.github.io/mongo-csharp-driver/2.23.0/api/MongoDB.Driver/MongoDB.Driver.ChangeStreamSplitEvent.html>`__
-  to handle change stream events greater than 16 MB.
-
-.. _version-2.22:
-
-What's New in 2.22
-------------------
-
-The 2.22 driver release includes the following new features:
-
-- Improvements and bug fixes to the LINQ3 integration.
-- Added support for :manual:`$set
-  </reference/operator/aggregation/set/>` and :atlas:`$vectorSearch
-  </atlas-vector-search/vector-search-stage/>` aggregation stages.
-- Added synonym support for Atlas Search.
-- Reduced memory allocation when using encryption.
-- Added logging messages for server discovery and monitoring (SDAM) events. For more
-  information on these events, see the
-  `MongoDB SDAM Logging and Monitoring specification. <https://github.com/mongodb/specifications/blob/master/source/server-discovery-and-monitoring/server-discovery-and-monitoring-logging-and-monitoring.rst#log-messages>`__
+  parameter more than once.