DOCSP-49341 EF v8.3 Release (#53)

Author: stephmarie17

config/redirects

@@ -1,6 +1,6 @@
 define: prefix docs/entity-framework
 define: base https://www.mongodb.com/${prefix}
-define: versions v7.0 v8.0 v8.1 v8.2 master
+define: versions v7.0 v8.0 v8.1 v8.2 v8.3 master
 
 raw: ${prefix}/ -> ${base}/current/
 raw: ${prefix}/stable -> ${base}/current/

snooty.toml

@@ -28,8 +28,8 @@ 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 = "8.2"                                                            # always set this to the driver branch (i.e. 1.7.0, 1.8.0, etc.)
-full-version = "{+version-number+}.3"
+version-number = "8.3"                                                            # always set this to the driver branch (i.e. 1.7.0, 1.8.0, etc.)
+full-version = "{+version-number+}.0"
 version = "v{+version-number+}"
 ef-core-version = "8.0"
 stable-api = "Stable API"

source/upgrade.txt

@@ -48,6 +48,50 @@ changes between the current and upgrade versions. For example, if you
 are upgrading the provider from v8.0 to v8.5, address all breaking changes from
 the version after v8.0, including any listed under v8.5.
 
+.. _entity-framework-breaking-changes-v8.3:
+
+Version 8.30.0 Breaking Changes
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Version 8.3.0 of the {+provider-short+} introduces a breaking change that
+corrects the handling of nullable properties configured with an alternative BSON
+representation. In previous versions, configurations set by the
+``[BsonRepresentation]`` attribute or the ``HasBsonRepresentation()`` fluent API
+were not applied. 
+
+You can take action to address this discrepency in one of two ways:
+
+- If using the alternative BSON representation is not critical, remove the
+  configuration from your application before it starts.
+
+- Alternatively, you can update the affected elments to the new representation.
+  As part of your upgrade process, use the ``updateMany`` method for each
+  affected MongoDB collection to rewrite any affected nullable properties or
+  elements into the desired BSON representation using the ``$convert``
+  operation.
+
+  For example, you can convert a ``dateOfBirth`` element in a collection named
+  ``people`` from a BSON ``date`` into BSON ``int`` as shown in the following
+  code:
+
+  .. code-block:: csharp
+
+      db.people.updateMany(
+        { dateOfBirth: {$type: "date" } },
+        [
+          { $set: { 
+              dateOfBirth: 
+                { $convert: 
+                  { input: "$dateOfBirth", 
+                    to: "int", 
+                    onNull: null 
+                  } 
+                } 
+            } 
+          }
+        ]
+      )
+
 .. _entity-framework-breaking-changes-v8.2:
 
 Version 8.2.0 Breaking Changes

source/whats-new.txt

@@ -19,6 +19,7 @@ What's New
 
 Learn what's new in:
 
+* :ref:`Version 8.3 <entity-framework-version-8.3>`
 * :ref:`Version 8.2.3 <entity-framework-version-8.2.3>`
 * :ref:`Version 8.2.2 <entity-framework-version-8.2.2>`
 * :ref:`Version 8.2.1 <entity-framework-version-8.2.1>`
@@ -32,6 +33,23 @@ Learn what's new in:
    changes to major version releases. Instead, breaking and significant changes
    are made in minor version releases.
 
+.. _entity-framework-version-8.3:
+
+What's New in 8.3
+-----------------
+
+The 8.3 provider release includes the following new features:
+
+- Adds support for setting BSON representation on ``PropertiesConfigurationBuilder``.
+
+- Adds configuration-level support for ``HasDateTimeKind()``.
+
+- Changes behavior to apply ``HasBsonRepresentation`` to nullable properties. To
+  learn more, see :ref:`entity-framework-breaking-changes-v8.3` in the
+  :ref:`entity-framework-upgrade-provider` guide.
+
+- Changes behavior to allow testing for nullabilty for navigation collections.
+
 .. _entity-framework-version-8.2.3:
 
 What's New in 8.2.3