diff --git a/source/index.txt b/source/index.txt index 49e4a4d6..c1cbfdcd 100644 --- a/source/index.txt +++ b/source/index.txt @@ -17,6 +17,7 @@ Read Data View the Source API Documentation <{+api-root+}> + What's New Compatibility .. TODO: @@ -28,7 +29,6 @@ Data Aggregation Security Issues & Help - What's New Upgrade Introduction @@ -89,11 +89,11 @@ working with data in the :ref:`ruby-get-started` tutorial. .. Learn how to authenticate your application and encrypt your data in the .. :ref:`ruby-security` section. -.. What's New -.. ---------- +What's New +---------- -.. For a list of new features and changes in each version, see the :ref:`What's New ` -.. section. +For a list of new features and changes in each version, see the :ref:`What's New ` +section. .. Upgrade Driver Versions .. ----------------------- diff --git a/source/whats-new.txt b/source/whats-new.txt new file mode 100644 index 00000000..caf13a4f --- /dev/null +++ b/source/whats-new.txt @@ -0,0 +1,68 @@ +.. _ruby-whats-new: + +========== +What's New +========== + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +.. facet:: + :name: genre + :values: reference + +.. meta:: + :keywords: update, new feature, deprecation, upgrade + +Learn what's new in: + +* :ref:`2.21 ` +* :ref:`2.20 ` + +.. _upcoming-breaking-changes: + +.. _version-2.21: + +What's New in 2.21 +------------------ + +The {+driver-short+} 2.21 release includes the following new features: + +- Supports the Client-Side Operations Timeout (CSOT) feature, which unifies + most timeout-related options under a single ``timeout_ms`` option. +- Supports {+mdb-server+} version 8.0. +- Support for range v2 queries with Queryable Encryption, including a new ``trim_factor`` + parameter. For more information about Queryable Encryption, see :manual:`Queryable Encryption ` + in the {+mdb-server+} manual. + +To learn more about this release, see the +:github:`v2.21 Release Notes ` on +GitHub. + +.. _version-2.20: + +What's New in 2.20 +------------------ + +The {+driver-short+} 2.20 release includes the following new features: + +- Discontinues support for Ruby 2.5 and 2.6. Deprecates support for Ruby 2.7 and + JRuby 9.2, which will be discontinued in the next minor driver version. Adds + support for JRuby 9.4. +- Supports the newly-released Ruby-BSON version 5.0. +- Allows connection strings without a slash between the hosts and the options. + For example, ``mongodb://example.com?w=1`` and ``mongodb://example.com/?w=1`` are + both valid connection strings now. +- Sends container runtime and orchestration metadata for the client environment + to the server for analytics purposes. +- Writes a warning message to the log when detecting the host as a CosmosDB + (Azure) or DocumentDB (Amazon) instance. +- Attempts retries of read or write operations on a different ``mongos`` + instance in a sharded topology, if possible. + +To learn more about this release, see the +:github:`v2.20 Release Notes ` on +GitHub. \ No newline at end of file