DOCSP-32130: v2.21 updates (#110)

* DOCSP-32130: v2.21 updates

Author: Chris Cho

config/redirects

@@ -1,6 +1,6 @@
 define: prefix docs/drivers/csharp
 define: base https://www.mongodb.com/${prefix}
-define: versions 2.19 2.20 master
+define: versions 2.19 2.20 2.21 master
 
 raw: ${prefix}/ -> ${base}/current/
 raw: ${prefix}/stable -> ${base}/current/

snooty.toml

@@ -25,7 +25,7 @@ language = "C#"
 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 = "2.20"                                                                                         # always set this to the driver branch (i.e. 1.7.0, 1.8.0, etc.)
+version-number = "2.21"                                                                                         # always set this to the driver branch (i.e. 1.7.0, 1.8.0, etc.)
 version = "v{+version-number+}"
 example = "https://raw.githubusercontent.com/mongodb/docs-csharp/{+docs-branch+}/source/includes/code-examples"
 stable-api = "Stable API"

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

@@ -16,6 +16,19 @@
      - .NET 4.7 [#2.14-note]_
      - .NET 4.6
      - .NET 4.5 [#4.5.2]_
+   * - 2.21
+     - ✓
+     - ✓
+     - ✓
+     - ✓
+     - ✓
+     - ✓
+     -
+     -
+     - ✓
+     - ✓
+     -
+     -
    * - 2.20
      - ✓
      - ✓

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

@@ -16,6 +16,19 @@
      - MongoDB 3.2
      - MongoDB 3.0
      - MongoDB 2.6
+   * - 2.21
+     - ✓
+     - ✓
+     - ✓
+     - ✓
+     - ✓
+     - ✓
+     - ✓
+     - ✓
+     -
+     -
+     -
+     -
    * - 2.20
      - ✓
      - ✓
@@ -28,7 +41,7 @@
      -
      -
      -
-     - 
+     -
    * - 2.19
      - ⊛
      - ✓
@@ -41,7 +54,7 @@
      -
      -
      -
-     - 
+     -
    * - 2.18
      - ⊛
      - ✓
@@ -302,5 +315,5 @@
      -
      - ✓
      - ✓
-    
+
 The driver doesn't support older versions of MongoDB.

source/upgrade.txt

@@ -50,14 +50,31 @@ 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-2.21.0:
+
+Version 2.21.0 Breaking Changes
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+- The function signature of ``Render`` methods in the Atlas Search builders
+  changed. The following code snippet shows the function signature prior
+  to the change and after the change:
+
+  .. code-block:: csharp
+
+     // Render function signature prior to v2.21.0
+     Render(IBsonSerializer<TDocument> documentSerializer, IBsonSerializerRegistry serializerRegistry);
+
+     // Render function signature in v2.21.0 and later
+     Render(SearchDefinitionRenderContext<TDocument> renderContext);
+
 Version 2.19.0 Breaking Changes
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 - The ``ObjectSerializer`` only allows deserialization of
   types that are considered safe. If not specified otherwise, the
   ``ObjectSerializer`` uses the types returned by
-  ``ObjectSerializer.DefaultAllowedTypes``. 
-  
+  ``ObjectSerializer.DefaultAllowedTypes``.
+
   To learn more about the ``ObjectSerializer``, visit the
   :ref:`FAQ <csharp-faq-object-serializer>`. For more information on
   ``DefaultAllowedTypes``, visit the `API Documentation
@@ -66,9 +83,9 @@ Version 2.19.0 Breaking Changes
 - The default ``LinqProvider`` has been changed to LINQ3. The ``LinqProvider``
   can be configured for LINQ2 in ``MongoClientSettings`` as shown in the
   following code example:
-  
+
   .. code-block:: csharp
-    
+
      var connectionString = "<connection string>";
      var clientSettings = MongoClientSettings
         .FromConnectionString(connectionString);
@@ -104,11 +121,11 @@ The driver discontinues support for a MongoDB Server version after it
 reaches end-of-life (EOL).
 
 To learn more about the MongoDB support for EOL products see the `Legacy
-Support Policy <https://www.mongodb.com/support-policy/legacy>`__. 
+Support Policy <https://www.mongodb.com/support-policy/legacy>`__.
 
 To learn more about the compatibility between .NET/C# driver versions
 and MongoDB Server versions, visit the
-:ref:`Compatibility <csharp-compatibility-tables>` page. 
+:ref:`Compatibility <csharp-compatibility-tables>` page.
 
 Version 2.14 Release Support Changes
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -120,4 +137,4 @@ Version 2.14 Release Support Changes
 
   - :ref:`<3.6-upgrade-replica-set>`
   - :ref:`<3.6-upgrade-standalone>`
-  - :ref:`<3.6-upgrade-sharded-cluster>`
+  - :ref:`<3.6-upgrade-sharded-cluster>`

source/whats-new.txt

@@ -12,14 +12,33 @@ What's New
 
 Learn what's new in:
 
+* :ref:`Version 2.21 <version-2.21>`
 * :ref:`Version 2.20 <version-2.20>`
 * :ref:`Version 2.19 <version-2.19>`
 
 .. _upcoming-breaking-changes:
 
+.. _version-2.21:
+
+What's New in 2.21
+------------------
+
+.. warning:: Breaking changes in v2.21
+
+   The v2.21 driver contains breaking changes. See :ref:`<csharp-breaking-changes-2.21.0>`
+   for more information.
+
+The 2.21 driver release includes the following new features:
+
+- Improvements and bug fixes to the LINQ3 integration.
+- Accepts options for Atlas Search sorting, tracking, and scoring.
+- Supports the Atlas Search :atlas:`embeddedDocument </atlas-search/embedded-document/>` operator.
+- Offers an API for Atlas Search index management.
+- Accepts anonymous types in the ``ObjectSerializer.DefaultAllowedTypes`` method.
+
 .. _version-2.20:
 
-What's New in 2.20 
+What's New in 2.20
 ------------------
 
 The 2.20 driver release includes the following new features:
@@ -32,12 +51,12 @@ The 2.20 driver release includes the following new features:
 
 .. _version-2.19:
 
-What's New in 2.19 
+What's New in 2.19
 ------------------
 
 The 2.19 driver release includes the following new features:
 
-- The ``ObjectSerializer`` allows deserialization of only safe types, as determined by 
+- The ``ObjectSerializer`` allows deserialization of only safe types, as determined by
   the configurable ``AllowedTypes`` function.
 - Changed the default ``LinqProvider`` to LINQ3.
 - Added Atlas Search (``$search``) support to builders, aggregation pipelines, and LINQ3.