DOCSP-30902: v1.12 release (#275)

* DOCSP-30902: v1.12 release

* build

* build

* fix

* CC and MD comments

* fix manual link

* cc comments

Author: rustagir

config/redirects

@@ -1,6 +1,6 @@
 define: prefix docs/drivers/go
 define: base https://www.mongodb.com/${prefix}
-define: versions 1.7 1.8 1.9 1.10 1.11 master
+define: versions 1.7 1.8 1.9 1.10 1.11 1.12 master
 
 symlink: current -> master
 

snooty.toml

@@ -17,7 +17,7 @@ sharedinclude_root = "https://raw.githubusercontent.com/10gen/docs-shared/main/"
 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.11.6" # always set this to the driver version (i.e. v1.7.0, v1.8.0, etc.)
+version = "v1.12.0" # always set this to the driver version (i.e. v1.7.0, v1.8.0, etc.)
 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/crud/write-read-pref.txt

@@ -150,12 +150,13 @@ requests acknowledgement from two replica set members and sets journaling to
 acknowledgement from the majority of replica set members.
 
 .. code-block:: go
-   :emphasize-lines: 2-6,10-11
+   :emphasize-lines: 2-7,11-12
 
    uri := "mongodb://<hostname>:<port>"
+   journal := false
    cliWC := &writeconcern.WriteConcern{
        W: 2,
-       Journal: false,
+       Journal: &journal,
    }
    clOpts := options.Client().ApplyURI(uri).SetWriteConcern(cliWC)
    client, err := mongo.Connect(context.TODO(), clOpts)

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

@@ -10,6 +10,8 @@ The first column lists the driver version.
 
    * - Go Driver Version
      - Minimum Go Language Version
+   * - 1.12
+     - 1.13
    * - 1.11
      - 1.13 
    * - 1.10

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

@@ -4,6 +4,7 @@
    :class: compatibility-large
 
    * - Go Driver Version
+     - MongoDB 7.0
      - MongoDB 6.1
      - MongoDB 6.0
      - MongoDB 5.0
@@ -15,19 +16,34 @@
      - MongoDB 3.2
      - MongoDB 3.0
      - MongoDB 2.6
-   * - 1.11
+   * - 1.12
      - ✓
      - ✓
      - ✓
      - ✓
      - ✓
      - ✓
      - ✓
+     - ✓
+     - 
+     - 
+     - 
+     - 
+   * - 1.11
      - ⊛
-     - ⊛
-     - ⊛
-     - ⊛   
+     - ✓
+     - ✓
+     - ✓
+     - ✓
+     - ✓
+     - ✓
+     - ✓
+     - 
+     - 
+     - 
+     - 
    * - 1.10
+     - ⊛
      - ⊛
      - ✓
      - ✓
@@ -40,6 +56,7 @@
      - ✓
      - ✓
    * - 1.9
+     - ⊛
      - ⊛
      - ⊛
      - ✓
@@ -52,6 +69,7 @@
      - ✓
      - ✓
    * - 1.8
+     - ⊛
      - ⊛
      - ⊛
      - ✓
@@ -64,6 +82,7 @@
      - ✓
      - ✓
    * - 1.7
+     - ⊛
      - ⊛
      - ⊛
      - ✓
@@ -76,6 +95,7 @@
      - ✓
      - ✓
    * - 1.6
+     - ⊛
      - ⊛
      - ⊛
      - ✓ [#go-1.6-driver-support]_
@@ -91,6 +111,7 @@
      - ⊛
      - ⊛
      - ⊛
+     - ⊛
      - ✓
      - ✓
      - ✓
@@ -103,6 +124,7 @@
      - ⊛
      - ⊛
      - ⊛
+     - ⊛
      - ✓
      - ✓
      - ✓
@@ -116,6 +138,7 @@
      - ⊛
      - ⊛
      - ⊛
+     - ⊛
      - ✓
      - ✓
      - ✓
@@ -128,6 +151,7 @@
      - ⊛
      - ⊛
      - ⊛
+     - ⊛
      - ✓
      - ✓
      - ✓
@@ -140,6 +164,7 @@
      - ⊛
      - ⊛
      - ⊛
+     - ⊛
      - ✓
      - ✓
      - ✓
@@ -153,6 +178,7 @@
      - ⊛
      - ⊛
      - ⊛
+     - ⊛
      - ✓
      - ✓
      - ✓

source/whats-new.txt

@@ -4,8 +4,6 @@
 What's New
 ==========
 
-.. default-domain:: mongodb
-
 .. contents:: On this page
    :local:
    :backlinks: none
@@ -45,6 +43,84 @@ What's New in 1.12
      deprecated. You can create a client and connect in one call
      by using the ``mongo.Connect()`` method.
 
+New features of the 1.12 Go driver release include: 
+
+Queryable Encryption
+~~~~~~~~~~~~~~~~~~~~
+
+This driver version adds support for :ref:`qe-manual-feature-qe` (QE). To learn
+more about the requirements for using the QE feature, see the
+:ref:`Queryable Encryption Driver Compatibility Table
+<qe-compatibility-reference>`.
+  
+The ``ClientEncryption.CreateEncryptedCollection()``
+method automatically creates data encryption keys when
+you create a new encrypted collection. To learn how to use the QE
+feature, see the :ref:`qe-quick-start` in the Server manual.
+
+Logging Interface
+~~~~~~~~~~~~~~~~~
+
+You can now record connection management and command execution events by
+using the ``LogSink`` logging interface.
+
+The ``LogSink`` interface is
+compatible with the `logr.LogSink <https://pkg.go.dev/github.com/go-logr/logr#LogSink>`__ interface.
+You can use existing ``logr`` adapters with the logging interface
+such as :github:`zerologr <go-logr/zerologr>` or :github:`zapr <go-logr/zapr>`.
+
+Alternatively, you can implement your own ``LogSink`` adapter. The following
+example shows how to implement logging with an existing :github:`zerolog
+<rs/zerolog>` logger, called ``myLogger``:
+
+.. code-block:: go
+
+   sink := zerologr.New(&myLogger).GetSink()
+   loggerOptions := options.Logger().SetSink(sink)
+   options.Client().SetLoggerOptions(loggerOptions)
+
+Additional BSON Marshalling Options
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+This driver version adds features to the ``options`` package to specify
+how the driver marshals and unmarshals BSON.
+
+The following example shows how to set BSON options on your
+``Client``. The options specify the following behaviors:
+
+- The driver falls back to ``json`` :ref:`struct tags
+  <golang-struct-tags>` if ``bson`` struct tags are absent.
+- The driver marshals ``nil`` Go map types as empty BSON documents.
+- The driver marshals ``nil`` Go slice types as empty BSON arrays.
+
+.. code-block:: go
+
+   bsonOpts := &options.BSONOptions{
+   	UseJSONStructTags: true,
+   	NilMapAsEmpty:     true,
+   	NilSliceAsEmpty:   true,
+   }
+   options.Client().SetBSONOptions(bsonOpts)
+
+For a full example of how to specify and implement the ``BSONOptions``
+type, see the `API documentation <{+api+}/mongo#example-Connect-BSONOptions>`__.
+
+Simplified Write Concern Specification
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+This driver version simplifies the ``WriteConcern`` API. To learn more about
+the changes, see :ref:`Write Concern <golang-writeconcern>`.
+
+Additional Changes
+~~~~~~~~~~~~~~~~~~
+
+- Support for authentication with AWS IAM roles in EKS.
+- Addition of the ``Cursor.SetBatchSize()`` method to allow
+  specification of the size of batches fetched when iterating through a
+  cursor.
+- Addition of the ``UnmarshalValue()`` method to allow ummarshalling of
+  BSON values marshalled with the ``MarshalValue()`` method.
+
 .. _version-1.11.0:
 .. _version-1.11: