v3.11 Release (#60)

Author: jordan-smith721

config/redirects

@@ -1,6 +1,6 @@
 define: prefix docs/languages/cpp/cpp-driver
 define: base https://www.mongodb.com/${prefix}
-define: versions v3.10 master
+define: versions v3.10 3.11 master
 
 symlink: current -> v3.10
 symlink: upcoming -> master

snooty.toml

@@ -24,8 +24,8 @@ sharedinclude_root = "https://raw.githubusercontent.com/10gen/docs-shared/main/"
 driver = "cpp"
 driver-long = "MongoDB C++ Driver"
 driver-short = "C++ driver"
-version = "3.10"
-full-version = "{+version+}.2"
+version = "3.11"
+full-version = "{+version+}.0"
 api = "https://mongocxx.org/api/current"
 string-data-type = "``string``"
 int-data-type = "``int``"

source/advanced-installation.txt

@@ -173,6 +173,7 @@ The mongocxx driver builds on top of the `MongoDB C driver <https://www.mongodb.
 The build of mongocxx-3.9.0 automatically downloads and installs the C driver if the C driver is not detected.
 To use an existing install of the C driver, set ``CMAKE_PREFIX_PATH`` to the directory containing the C driver install.
 
+- For mongocxx-3.11.x, libmongoc 1.28.0 or later is required.
 - For mongocxx-3.10.x, libmongoc 1.25.0 or later is required.
 - For mongocxx-3.9.x, libmongoc 1.25.0 or later is required.
 - For mongocxx-3.8.x, libmongoc 1.24.0 or later is required.

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

@@ -9,7 +9,7 @@
      - C++14
      - C++11
 
-   * - 3.8 to 3.10
+   * - 3.8 to 3.11
      - ✓
      - ✓
      - ✓

source/index.txt

@@ -147,11 +147,16 @@ For documentation about previous releases, see the `legacy documentation <https:
      - Active development
      - New feature development
 
-   * - mongocxx 3.10.x
+   * - mongocxx 3.11.x
      - Stable
      - Bug fixes only
      - Current stable C++ driver release 
 
+   * - mongocxx 3.10.x
+     - Stable
+     - None
+     - Previous stable C++ driver release  
+
    * - mongocxx 3.9.x 
      - Stable
      - None          

source/upgrade.txt

@@ -66,6 +66,32 @@ and upgrade versions.
   If you're upgrading the {+driver-short+} from version 3.0 to version 3.10,
   address all breaking changes listed for versions 3.1 to 3.10, if any.
 
+.. _version-3.11-breaking-changes:
+
+Version 3.11 Breaking Changes
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+- Drops support for {+mdb-server+} v3.6.
+- Requires MongoDB C Driver v1.28.0 or later.
+- Removes export of the following private member functions in the bsoncxx
+  ABI:
+   
+  - ``bsoncxx::v_noabi::types::bson_value::value::value(const uint8_t*, uint32_t, uint32_t, uint32_t)``
+  - ``bsoncxx::v_noabi::types::bson_value::view::_init(void*)``
+  - ``bsoncxx::v_noabi::types::bson_value::view::view(const uint8_t*, uint32_t, uint32_t, uint32_t)``
+  - ``bsoncxx::v_noabi::types::bson_value::view::view(void*)``
+
+- Removes export of the following private member functions in the mongocxx
+  ABI:
+   
+  - ``mongocxx::v_noabi::options::change_stream::as_bson()``
+  - ``mongocxx::v_noabi::options::aggregate::append(bsoncxx::v_noabi::builder::basic::document&)``
+  - ``mongocxx::v_noabi::options::index::storage_options()``
+   
+- Declare all exported functions symbols with ``__cdecl`` when compiled with
+  MSVC. This is an ABI breaking change if you use an alternative
+  default calling convention when building projects.
+
 .. _version-3.10-breaking-changes:
 
 Version 3.10 Breaking Changes

source/whats-new.txt

@@ -22,6 +22,7 @@ Overview
 
 Learn what's new in:
 
+* :ref:`Version 3.11 <version-3.11>`
 * :ref:`Version 3.10 <version-3.10>`
 * :ref:`Version 3.9 <version-3.9>`
 
@@ -73,6 +74,49 @@ New versions of the {+driver-short+} can introduce the following types of breaki
 
 .. _upcoming-breaking-changes:
 
+.. _version-3.11:
+
+What's New in 3.11
+------------------
+
+.. warning:: Breaking Changes
+
+   The v3.11 driver introduces the following breaking changes:
+   
+   - Drops support for {+mdb-server+} v3.6.
+   - Requires MongoDB C Driver v1.28.0 or later.
+   - Removes export of the following private member functions in the bsoncxx
+     ABI:
+   
+     - ``bsoncxx::v_noabi::types::bson_value::value::value(const uint8_t*, uint32_t, uint32_t, uint32_t)``
+     - ``bsoncxx::v_noabi::types::bson_value::view::_init(void*)``
+     - ``bsoncxx::v_noabi::types::bson_value::view::view(const uint8_t*, uint32_t, uint32_t, uint32_t)``
+     - ``bsoncxx::v_noabi::types::bson_value::view::view(void*)``
+
+   - Removes export of the following private member functions in the mongocxx
+     ABI:
+   
+     - ``mongocxx::v_noabi::options::change_stream::as_bson()``
+     - ``mongocxx::v_noabi::options::aggregate::append(bsoncxx::v_noabi::builder::basic::document&)``
+     - ``mongocxx::v_noabi::options::index::storage_options()``
+   
+   - Declare all exported functions symbols with ``__cdecl`` when compiled with
+     MSVC. This is an ABI breaking change if you use an alternative
+     default calling convention when building projects.
+
+The v3.11 driver release includes the following new features:
+
+- Adds support for {+mdb-server+} v8.0.
+- Adds support for Queryable Encryption range queries. To use this
+  feature, your app must connect to {+mdb-server+} 8.0 or later. For
+  more information about Queryable Encryption, see :manual:`Queryable
+  Encryption </core/queryable-encryption>` in the {+mdb-server+} manual.
+- Adds ``empty()`` member function for ``mongocxx::v_noabi::bulk_write``.
+
+To learn more about this release, see the
+`v3.11 Release Notes <https://github.com/mongodb/mongo-cxx-driver/releases/tag/r3.11.0>`__
+on GitHub.
+
 .. _version-3.10:
 
 What's New in 3.10