mongodb
diff --git a/‎content/golang/current/source/get-started.txt‎
Lines changed: 0 additions & 2 deletions b/‎content/golang/current/source/get-started.txt‎
Lines changed: 0 additions & 2 deletions
diff --git a/‎content/golang/upcoming/snooty.toml‎
Lines changed: 3 additions & 3 deletions b/‎content/golang/upcoming/snooty.toml‎
Lines changed: 3 additions & 3 deletions
diff --git a/‎content/golang/upcoming/source/fundamentals/aggregation.txt‎ renamed to ‎content/golang/upcoming/source/aggregation.txt‎
Lines changed: 6 additions & 0 deletions b/‎content/golang/upcoming/source/fundamentals/aggregation.txt‎ renamed to ‎content/golang/upcoming/source/aggregation.txt‎
Lines changed: 6 additions & 0 deletions
diff --git a/‎content/golang/upcoming/source/atlas-search.txt‎
Lines changed: 111 additions & 0 deletions b/‎content/golang/upcoming/source/atlas-search.txt‎
Lines changed: 111 additions & 0 deletions
diff --git a/‎content/golang/upcoming/source/fundamentals/atlas-vector-search.txt‎ renamed to ‎content/golang/upcoming/source/atlas-vector-search.txt‎ b/‎content/golang/upcoming/source/fundamentals/atlas-vector-search.txt‎ renamed to ‎content/golang/upcoming/source/atlas-vector-search.txt‎
diff --git a/‎content/golang/upcoming/source/connect.txt‎
Lines changed: 45 additions & 0 deletions b/‎content/golang/upcoming/source/connect.txt‎
Lines changed: 45 additions & 0 deletions
diff --git a/‎content/golang/upcoming/source/connect/connection-options/cluster-settings.txt‎
Lines changed: 204 additions & 0 deletions b/‎content/golang/upcoming/source/connect/connection-options/cluster-settings.txt‎
Lines changed: 204 additions & 0 deletions
@@ -18,8 +18,6 @@ Getting Started with Go
    :depth: 1
    :class: singlecol
 
-.. adapted from quick start, should be checked
-
 .. include:: /includes/quick-start/overview.rst
 
 Set Up Your Project
 
@@ -1,9 +1,9 @@
 name = "golang"
 title = "Go Driver"
 toc_landing_pages = [
-    "/fundamentals/connections",
-    "/fundamentals/crud",
-    "/usage-examples",
+    "/connect/specify-connection-options",
+    "/crud/update",
+    "/security/authentication",
 ]
 
 intersphinx = [
 
@@ -25,6 +25,12 @@ pipeline consists of one or more **stages**. Each stage performs an
 operation based on its expression operators. After the driver executes
 the aggregation pipeline, it returns an aggregated result.
 
+.. sharedinclude:: dbx/agg-tutorials-manual-tip.rst
+
+   .. replacement:: language
+
+      :guilabel:`{+language+}`
+
 Analogy
 ~~~~~~~
 
 
@@ -0,0 +1,111 @@
+.. _golang-atlas-search:
+
+=========================
+Run an Atlas Search Query
+=========================
+
+.. facet::
+   :name: genre
+   :values: reference
+
+.. meta::
+   :keywords: full text, text analyzer, meta, pipeline, scoring, Lucene
+   :description: Learn about how to use Atlas Search in the {+driver-long+}.
+
+.. contents:: On this page
+   :local:
+   :backlinks: none
+   :depth: 2
+   :class: singlecol
+
+Overview
+--------
+
+In this guide, you can learn how to use the {+driver-short+} to
+run :atlas:`Atlas Search </atlas-search/>` queries on a collection.
+Atlas Search enables you to perform full-text searches on collections
+hosted on MongoDB Atlas. Atlas Search indexes specify the behavior of the
+search and which fields to index.
+
+Sample Data
+~~~~~~~~~~~
+
+The example in this guide uses the ``movies`` collection in the ``sample_mflix``
+database from the :atlas:`Atlas sample datasets </sample-data>`. To learn how to
+create a free MongoDB Atlas cluster and load the sample datasets, see the
+:atlas:`Get Started with Atlas </getting-started>` guide.
+
+Run an Atlas Search Query
+-------------------------
+
+This section shows how to create an aggregation pipeline to run an
+Atlas Search query on a collection. 
+
+To run an Atlas Search query, you must create an Atlas Search index on your
+collection. To learn how to programmatically create 
+an Atlas Search index, see the :ref:`golang-atlas-search-indexes` section of the 
+Indexes guide.
+
+After you create an Atlas Search index, add the ``$search`` stage in your array 
+of pipeline stages to specify the search criteria. Then, call
+the ``Aggregate()`` method and pass your pipeline array as a parameter.
+
+.. tip:: 
+
+   To learn more about aggregation operations, see the :ref:`golang-aggregation`
+   guide. 
+
+Atlas Search Example
+~~~~~~~~~~~~~~~~~~~~
+
+This example runs an Atlas Search query by performing the
+following actions:
+
+- Creates a ``$search`` stage that instructs the driver
+  to query for documents in which the ``title`` field contains
+  the word ``"Alabama"``
+
+- Creates a ``$project`` stage that instructs the driver to
+  include the ``title`` field in the query results
+
+- Passes the pipeline stages to the ``Aggregate()`` method and
+  prints the results
+
+.. io-code-block::
+   :copyable:
+    
+   .. input:: /includes/fundamentals/code-snippets/indexes/atlasSearch.go
+      :start-after: begin-atlas-search
+      :end-before: end-atlas-search
+      :language: go
+      :dedent:
+
+   .. output:: 
+      :language: console
+      :visible: false
+
+      {
+        _id: new ObjectId('...'),
+        title: 'Alabama Moon'
+      }
+      {
+        _id: new ObjectId('...'),
+        title: 'Crazy in Alabama'
+      }
+      {
+        _id: new ObjectId('...'),
+        title: 'Sweet Home Alabama'
+      }
+
+Additional Information
+----------------------
+
+To learn more about Atlas Search, see the :atlas:`Atlas Search </atlas-search/>`
+guides and the :atlas:`$search </atlas-search/aggregation-stages/search/>` pipeline 
+stage reference in the Atlas documentation.
+
+API Documentation
+~~~~~~~~~~~~~~~~~
+
+To learn more about the ``Aggregate()`` method, see the
+`API documentation <{+api+}/mongo#Collection.Aggregate>`__.
@@ -0,0 +1,45 @@
+.. _golang-connection-guide:
+.. _golang-connection:
+.. _golang-connect:
+
+================
+Connection Guide
+================
+
+.. facet::
+   :name: genre
+   :values: tutorial
+
+.. meta::
+   :description: Learn how to use the MongoDB Go Driver to connect to MongoDB.
+   :keywords: connection string, client options, replica set, code example
+
+.. contents:: On this page
+   :local:
+   :backlinks: none
+   :depth: 2
+   :class: singlecol
+
+.. toctree::
+   :titlesonly:
+   :maxdepth: 1
+
+   Create a MongoClient </connect/mongoclient>
+   Choose a Connection Target </connect/connection-targets>
+   Connection Options </connect/specify-connection-options>
+   Connection Troubleshooting </connect/connection-troubleshooting>
+   Connect with AWS Lambda <https://www.mongodb.com/docs/atlas/manage-connections-aws-lambda/>
+
+Overview
+--------
+
+Learn how to set up a connection and specify connection behavior from your
+application to a MongoDB deployment using the {+driver-short+} in the following
+sections:
+
+- :ref:`golang-mongoclient`
+- :ref:`golang-connection-options`
+- :ref:`golang-connection-troubleshooting`
+
+For more information about authenticating with a MongoDB instance, see the
+:ref:`golang-authentication` section.
@@ -0,0 +1,204 @@
+.. _golang-cluster-settings:
+
+==========================
+Customize Cluster Settings
+==========================
+
+.. contents:: On this page
+   :local:
+   :backlinks: none
+   :depth: 2
+   :class: singlecol
+
+.. facet::
+   :name: genre
+   :values: reference
+
+.. meta::
+   :keywords: code example, connection string, connection options
+
+Overview
+--------
+
+In this guide, you can learn how the {+driver-short+} manages clusters and how
+to customize the cluster settings.
+
+Specify Settings
+----------------
+
+You can specify settings for your clusters by using either a connection string
+or a ``ClientOptions`` struct when creating a new ``Client``
+instance. Select the :guilabel:`Connection String` or :guilabel:`ClientOptions` tab to see the
+available options.
+
+.. tabs::
+
+  .. tab:: Connection String
+    :tabid: uri
+
+    The following table describes the parameters you can use in your connection
+    string to modify the driver's behavior when interacting with your MongoDB
+    cluster:
+
+    .. list-table::
+       :header-rows: 1
+       :stub-columns: 1
+       :widths: 40 60
+
+       * - Parameter
+         - Description 
+
+       * - ``serverSelectionTimeoutMS``
+         - Specifies the maximum amount of time the driver will wait for a server to
+           be available before throwing an error.
+
+           *Default:* 30 seconds
+
+       * - ``localThresholdMS``
+         - Specifies the maximum latency in milliseconds for selecting a server.
+           
+           *Default:* 15 milliseconds
+
+       * - ``replicaSet``
+         - Specifies the name of the replica set to connect to.
+
+       * - ``directConnection``
+         - Specifies whether to connect directly to a single server, bypassing the
+           replica set or sharded cluster.
+
+           *Default:* ``false``
+
+       * - ``loadBalanced``
+         - Specifies whether the driver is connecting to MongoDB by using a load
+           balancer. If set to ``true``, the driver assumes that it is
+           connecting through a load balancer.
+
+           You can set this option to ``true`` only if you meet the following requirements:
+
+           - You specify only one host name
+           - You aren't connecting to a replica set
+           - The ``srvMaxHosts`` option is unset or has a value of ``0``
+           - The ``directConnection`` option is unset or has a value of ``false``
+
+           *Default:* ``false``
+
+       * - ``srvServiceName``
+         - Specifies the service name of the `SRV resource records
+           <https://www.rfc-editor.org/rfc/rfc2782>`__ the driver retrieves to
+           construct your :manual:`seed list
+           </reference/glossary/#std-term-seed-list>`. You must use the
+           :manual:`DNS Seed List Connection Format
+           </reference/connection-string/#srv-connection-format>` in
+           your connection string to use this option.
+
+  .. tab:: ClientOptions
+    :tabid: options
+
+    The following table describes several methods you can chain to your
+    ``ClientOptions`` struct to modify the driver's behavior:
+
+    .. list-table::
+       :header-rows: 1
+       :stub-columns: 1
+       :widths: 40 60
+
+       * - Method
+         - Description 
+
+       * - ``SetServerSelectionTimeout()``
+         - Specifies the maximum amount of time the driver will wait for a server to
+           be available before throwing an error.
+
+           *Default:* 30 seconds
+
+       * - ``SetLocalThreshold()``
+         - Specifies the maximum latency in milliseconds for selecting a server.
+           
+           *Default:* 15 milliseconds
+
+       * - ``SetReplicaSet()``
+         - Specifies the name of the replica set to connect to.
+
+       * - ``SetDirect()``
+         - Specifies whether to connect directly to a single server, bypassing the
+           replica set or sharded cluster.
+
+           *Default:* ``false``
+
+       * - ``SetLoadBalanced()``
+         - Specifies whether the driver is connecting to MongoDB by using a
+           load balancer. If set to ``true``, the driver assumes that it is
+           connecting through a load balancer. 
+          
+           You can set this option to ``true`` only if you meet the following requirements:
+
+           - You specify only one host name
+           - You aren't connecting to a replica set
+           - The ``srvMaxHosts`` option is unset or has a value of ``0``
+           - The ``directConnection`` option is unset or has a value of ``false``
+
+           *Default:* ``false``
+
+       * - ``SetSRVServiceName()``
+         - Specifies a custom service name of the `SRV resource records
+           <https://www.rfc-editor.org/rfc/rfc2782>`__ the driver retrieves to
+           construct your :manual:`seed list
+           </reference/glossary/#std-term-seed-list>`. To use a custom SRV
+           service name in SRV discovery, you must call this function before you
+           call ``ApplyURI()``.
+
+    To learn more about the available methods, see the :ref:`golang-cluster-settings-resources` section.
+
+Example
+~~~~~~~
+
+Select the :guilabel:`Connection String` or :guilabel:`ClientOptions`  tab to
+see the corresponding example:
+
+.. tabs::
+
+    .. tab:: Connection String
+      :tabid: uriExample
+
+      The following code uses the connection string to configure the maximum
+      server selection timeout to 10 seconds and the local threshold to 20
+      milliseconds:
+
+      .. literalinclude:: /includes/connect/cluster-settings-uri.go
+        :language: go
+        :start-after: start-uri-variable
+        :end-before: end-uri-variable
+        :dedent:
+
+      The following code creates a client and passes the connection string to the
+      ``ApplyURI()`` method:
+
+      .. literalinclude:: /includes/connect/cluster-settings-uri.go
+        :language: go
+        :start-after: start-apply-uri
+        :end-before: end-apply-uri
+        :dedent:
+
+    .. tab:: ClientOptions
+      :tabid: optionsExample
+
+      The following code creates a client and sets the cluster options with a
+      maximum server selection timeout of 10 seconds and a local threshold of
+      20 milliseconds:
+
+      .. literalinclude:: /includes/connect/cluster-settings-client-options.go
+        :language: go
+        :start-after: start-client-options
+        :end-before: end-client-options
+        :dedent:
+
+.. _golang-cluster-settings-resources:
+
+API Documentation
+-----------------
+
+To learn more about the methods and types in this guide, see the following API documentation:
+
+- `Client <{+api+}/mongo#Client>`__
+- `ClientOptions <{+api+}/mongo/options#ClientOptions>`__
+- `ApplyURI() <{+api+}/mongo/options#ClientOptions.ApplyURI>`__