DOCSP-45210 What's New (#99)

Author: stephmarie17

source/index.txt

@@ -19,6 +19,7 @@
    Indexes </indexes>
    View the Source <https://github.com/mongodb/mongo-ruby-driver>
    API Documentation <{+api-root+}>
+   What's New </whats-new>
    Compatibility </compatibility>
 
 .. TODO:
@@ -29,7 +30,6 @@
  Data Aggregation </aggregation>
  Security </security>
  Issues & Help </issues-and-help>
- What's New </whats-new>
  Upgrade </upgrade>
 
 Introduction
@@ -90,11 +90,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 <ruby-whats-new>`
-.. section.
+For a list of new features and changes in each version, see the :ref:`What's New <ruby-whats-new>`
+section.
 
 .. Upgrade Driver Versions
 .. -----------------------

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 <version-2.21>`
+* :ref:`2.20 <version-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 </core/queryable-encryption>`
+  in the {+mdb-server+} manual.
+
+To learn more about this release, see the
+:github:`v2.21 Release Notes <mongodb/mongo-ruby-driver/releases/tag/v2.21.0>` 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 <mongodb/mongo-ruby-driver/releases/tag/v2.20.0>` on
+GitHub.