DOCSP-43664: v1.17 release (other changes)

config/redirects

@@ -1,6 +1,6 @@
 define: prefix docs/drivers/go
 define: base https://www.mongodb.com/${prefix}
-define: versions v1.7 v1.8 v1.9 v1.10 v1.11 v1.12 v1.13 v1.14 v1.15 v1.16 master
+define: versions v1.7 v1.8 v1.9 v1.10 v1.11 v1.12 v1.13 v1.14 v1.15 v1.16 v1.17 master
 
 symlink: current -> master
 

snooty.toml

@@ -16,8 +16,8 @@ sharedinclude_root = "https://raw.githubusercontent.com/10gen/docs-shared/main/"
 [constants]
 driver-long = "MongoDB Go Driver"
 driver-short = "Go driver"
-docs-branch = "master"                                                                                                         # always set this to the docs branch (i.e. master, 1.7, 1.8, etc.)
-version = "v1.16.1"                                                                                                            # always set this to the driver version (i.e. v1.7.0, v1.8.0, etc.)
+docs-branch = "master"
+version = "v1.17.0"
 example = "https://raw.githubusercontent.com/mongodb/docs-golang/{+docs-branch+}/source/includes/usage-examples/code-snippets"
 api = "https://pkg.go.dev/go.mongodb.org/mongo-driver@{+version+}"
 stable-api = "Stable API"

source/fundamentals/enterprise-auth.txt

@@ -492,6 +492,5 @@ API Documentation
 
 - `Credential <{+api+}/mongo/options#Credential>`__ type
 - `SetAuth() <{+api+}/mongo/options#ClientOptions.SetAuth>`__ method
-
-.. TODO - `OIDCCredential <{+api+}/...>`__ type
-.. TODO - `OIDCCallback <{+api+}/...>`__ function
+- `OIDCCredential <{+api+}/mongo/options#OIDCCredential>`__ type
+- `OIDCCallback <{+api+}/mongo/options#OIDCCallback>`__ function

source/includes/mongodb-compatibility-table-go.rst

@@ -13,28 +13,9 @@
      - MongoDB 4.2
      - MongoDB 4.0
      - MongoDB 3.6
-     - MongoDB 3.4
-     - MongoDB 3.2
-     - MongoDB 3.0
-     - MongoDB 2.6
-
-   * - 1.18
-     - ✓
-     - ✓
-     - ✓
-     - ✓
-     - ✓
-     - ✓
-     - ✓
-     - ✓
-     - ✓
-     - 
-     - 
-     - 
-     - 
 
    * - 1.12 to 1.17
-     - ⊛
+     - ⊛ [#8.0-support]_
      - ✓
      - ✓
      - ✓
@@ -43,10 +24,6 @@
      - ✓
      - ✓
      - ✓
-     - 
-     - 
-     - 
-     - 
 
    * - 1.11
      - ⊛
@@ -58,175 +35,5 @@
      - ✓
      - ✓
      - ✓
-     - 
-     - 
-     - 
-     - 
-
-   * - 1.10
-     - ⊛
-     - ⊛
-     - ⊛
-     - ✓
-     - ✓
-     - ✓
-     - ✓
-     - ✓
-     - ✓
-     - ✓
-     - ✓
-     - ✓
-     - ✓
-
-   * - 1.9
-     - ⊛
-     - ⊛
-     - ⊛
-     - ⊛
-     - ✓
-     - ✓
-     - ✓
-     - ✓
-     - ✓
-     - ✓
-     - ✓
-     - ✓
-     - ✓
-
-   * - 1.8
-     - ⊛
-     - ⊛
-     - ⊛
-     - ⊛
-     - ✓
-     - ✓
-     - ✓
-     - ✓
-     - ✓
-     - ✓
-     - ✓
-     - ✓
-     - ✓
-
-   * - 1.7
-     - ⊛
-     - ⊛
-     - ⊛
-     - ⊛
-     - ✓
-     - ✓
-     - ✓
-     - ✓
-     - ✓
-     - ✓
-     - ✓
-     - ✓
-     - ✓
-
-   * - 1.6
-     - ⊛
-     - ⊛
-     - ⊛
-     - ⊛
-     - ✓ [#go-1.6-driver-support]_
-     - ✓
-     - ✓
-     - ✓
-     - ✓
-     - ✓
-     - ✓
-     - ✓
-     - ✓
-
-   * - 1.5
-     - ⊛
-     - ⊛
-     - ⊛
-     - ⊛
-     - ⊛
-     - ✓
-     - ✓
-     - ✓
-     - ✓
-     - ✓
-     - ✓
-     - ✓
-     - ✓
-
-   * - 1.4
-     - ⊛
-     - ⊛
-     - ⊛
-     - ⊛
-     - ⊛
-     - ✓
-     - ✓
-     - ✓
-     - ✓
-     - ✓
-     - ✓
-     - ✓
-     - ✓
-
-   * - 1.3
-     - ⊛
-     - ⊛
-     - ⊛
-     - ⊛
-     - ⊛
-     - ⊛
-     - ✓
-     - ✓
-     - ✓
-     - ✓
-     - ✓
-     - ✓
-     - ✓
-
-   * - 1.2
-     - ⊛
-     - ⊛
-     - ⊛
-     - ⊛
-     - ⊛
-     - ⊛
-     - ✓
-     - ✓
-     - ✓
-     - ✓
-     - ✓
-     - ✓
-     - ✓
-
-   * - 1.1
-     - ⊛
-     - ⊛
-     - ⊛
-     - ⊛
-     - ⊛
-     - ⊛
-     - ✓
-     - ✓
-     - ✓
-     - ✓
-     - ✓
-     - ✓
-     - ✓
-
-   * - 1.0
-     - ⊛
-     - ⊛
-     - ⊛
-     - ⊛
-     - ⊛
-     - ⊛
-     - ⊛
-     - ✓
-     - ✓
-     - ✓
-     - ✓
-     - ✓
-     - ✓
 
-.. [#go-1.6-driver-support] The 1.6 driver does not support snapshot reads on secondaries. For more
-   information, see the `MongoDB Server version 5.0 release notes <https://www.mongodb.com/docs/v5.0/release-notes/5.0/#snapshots>`__.
+.. [#8.0-support] {+driver-short+} v1.17 is partially compatible with {+mdb-server+} 8.0 but does not support client bulk write.

source/whats-new.txt

@@ -27,6 +27,7 @@ What's New
 Learn what's new in:
 
 * :ref:`Version 2.0 <golang-version-2.0>`
+* :ref:`Version 1.17 <golang-version-1.17>`
 * :ref:`Version 1.16 <version-1.16>`
 * :ref:`Version 1.15.1 <version-1.15.1>`
 * :ref:`Version 1.15 <version-1.15>`
@@ -171,6 +172,40 @@ This release includes the following improvements and fixes:
 
 - The ``Collection.Clone()`` method does not return an error.
 
+.. _golang-version-1.17:
+
+What's New in 1.17
+------------------
+
+.. important::
+
+   v1.17 is the final planned 1.x version release. This version will
+   receive security and bug fixes, but future development and features
+   will be included only in 2.x versions of the driver.
+
+The 1.17 {+driver-short+} release includes the following improvements
+and fixes:
+
+- Adds support for OpenID Connect (OIDC) authentication. To learn more, see
+  the :ref:`golang-mongodb-oidc` section of the Enterprise
+  Authentication Mechanisms guide.
+
+- Adds support for Queryable Encryption (QE) range queries. To use this
+  feature, your app must connect to {+mdb-server+} 8.0 or later. For
+  more information about QE range queries, see :manual:`Queryable
+  Encryption </core/queryable-encryption>` in the {+mdb-server+} manual.
+
+- Adds support for {+mdb-server+} 8.0, except for
+  the client bulk write feature.
+
+- Extends the ``IndexView`` type to include the
+  ``DropOneWithKey()`` and ``DropWithKey()`` methods so you can
+  drop indexes by using their key specifications instead of their names.
+
+For more information about the changes in this version, see the
+:github:`v1.17 release notes
+</mongodb/mongo-go-driver/releases/tag/v1.17.0>` on GitHub.
+
 .. _version-1.16:
 
 What's New in 1.16