From d2c85e9bc06eee3cf5b2332c246e9cf9b1ae5951 Mon Sep 17 00:00:00 2001
From: Jordan Smith <45415425+jordan-smith721@users.noreply.github.com>
Date: Fri, 4 Oct 2024 07:07:05 -0700
Subject: [PATCH] v3.11 Release (#60)

---
 config/redirects                              |  2 +-
 snooty.toml                                   |  4 +-
 source/advanced-installation.txt              |  1 +
 .../language-compatibility-table-cxx.rst      |  2 +-
 source/index.txt                              |  7 ++-
 source/upgrade.txt                            | 26 +++++++++++
 source/whats-new.txt                          | 44 +++++++++++++++++++
 7 files changed, 81 insertions(+), 5 deletions(-)

diff --git a/config/redirects b/config/redirects
index 1d89b6eb..0a446c9a 100644
--- a/config/redirects
+++ b/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
diff --git a/snooty.toml b/snooty.toml
index 74512ad1..55426e98 100644
--- a/snooty.toml
+++ b/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``"
diff --git a/source/advanced-installation.txt b/source/advanced-installation.txt
index 630ca9c9..b4969bdd 100644
--- a/source/advanced-installation.txt
+++ b/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.
diff --git a/source/includes/language-compatibility-table-cxx.rst b/source/includes/language-compatibility-table-cxx.rst
index e9ee8f28..79d1065c 100644
--- a/source/includes/language-compatibility-table-cxx.rst
+++ b/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
      - ✓
      - ✓
      - ✓
diff --git a/source/index.txt b/source/index.txt
index ec19e8f8..be1e6525 100644
--- a/source/index.txt
+++ b/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          
diff --git a/source/upgrade.txt b/source/upgrade.txt
index 374fff96..a521a630 100644
--- a/source/upgrade.txt
+++ b/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
diff --git a/source/whats-new.txt b/source/whats-new.txt
index 98656466..62f926fb 100644
--- a/source/whats-new.txt
+++ b/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