Comp cov

config/redirects

@@ -10,3 +10,24 @@ symlink: current -> v5.5
 raw: ${prefix}/ -> ${base}/current/
 raw: ${prefix}/master -> ${base}/upcoming/
 [v5.1-*]: ${prefix}/${version}/get-started/connect-to-mongodb -> ${base}/${version}/get-started/run-sample-query/
+
+[*-master]: ${prefix}/${version}/connect/tls -> ${base}/${version}/security/tls
+[*-master]: ${prefix}/${version}/write/insert -> ${base}/${version}/crud/insert
+[*-master]: ${prefix}/${version}/write/update -> ${base}/${version}/crud/update
+[*-master]: ${prefix}/${version}/write/delete -> ${base}/${version}/crud/delete
+[*-master]: ${prefix}/${version}/write/bulk-write -> ${base}/${version}/crud/bulk-write
+[*-master]: ${prefix}/${version}/write/replace -> ${base}/${version}/crud/replace
+[*-master]: ${prefix}/${version}/write/transactions -> ${base}/${version}/crud/transactions
+[*-master]: ${prefix}/${version}/read/specify-a-query -> ${base}/${version}/crud/query/specify-a-query
+[*-master]: ${prefix}/${version}/read/retrieve -> ${base}/${version}/crud/query/find
+[*-master]: ${prefix}/${version}/read/specify-documents-to-return -> ${base}/${version}/crud/query/specify-documents-to-return
+[*-master]: ${prefix}/${version}/read/project -> ${base}/${version}/crud/query/project
+[*-master]: ${prefix}/${version}/read/count -> ${base}/${version}/crud/query/count
+[*-master]: ${prefix}/${version}/read/distinct -> ${base}/${version}/crud/query/distinct
+[*-master]: ${prefix}/${version}/read/cursors -> ${base}/${version}/crud/query/cursors
+[*-master]: ${prefix}/${version}/monitoring -> ${base}/${version}/logging-and-monitoring/monitoring
+[*-master]: ${prefix}/${version}/read/change-streams -> ${base}/${version}/logging-and-monitoring/change-streams
+[*-master]: ${prefix}/${version}/whats-new -> ${base}/${version}/reference/whats-new
+[*-master]: ${prefix}/${version}/compatibility -> ${base}/${version}/reference/compatibility
+[*-master]: ${prefix}/${version}/validate-signatures -> ${base}/${version}/security/validate-signatures
+[*-master]: ${prefix}/${version}/agg-exp-ops -> ${base}/${version}/aggregation/agg-exp-ops

snooty.toml

@@ -8,14 +8,16 @@ intersphinx = [
 ]
 
 toc_landing_pages = [
-    "/write-operations",
-    "/read",
     "/connect",
     "/indexes",
-    "work-with-indexes",
+    "/work-with-indexes",
     "/data-formats",
     "/builders",
     "/aggregation",
+    "/connect/connection-options",
+    "/logging-and-monitoring",
+    "/databases-and-collections",
+    "/security/authentication"
 ]
 
 sharedinclude_root = "https://raw.githubusercontent.com/10gen/docs-shared/main/"
@@ -36,3 +38,5 @@ kotlin-docs = "https://kotlinlang.org"
 serialization-version = "1.6.0"
 kotlinx-dt-version = "0.6.1"
 mongocrypt-version = "{+full-version+}"
+logbackVersion = "1.2.11"
+log4j2Version = "2.17.1"

source/aggregation.txt

@@ -1,8 +1,8 @@
 .. _kotlin-sync-aggregation:
 
-====================================
-Transform Your Data with Aggregation
-====================================
+======================
+Aggregation Operations
+======================
 
 .. facet::
    :name: genre
@@ -18,9 +18,11 @@ Transform Your Data with Aggregation
    :depth: 2
    :class: singlecol
 
-.. .. toctree::
-..    :titlesonly:
-..    :maxdepth: 1
+.. toctree::
+   :titlesonly:
+   :maxdepth: 1
+
+   Aggregation Expressions </aggregation/agg-exp-ops>
 
 ..    /aggregation/aggregation-tutorials
 
@@ -200,38 +202,10 @@ an aggregation pipeline that contains one of the following pipeline stages:
 - ``$search``
 - ``$searchMeta``
 
-To learn more about Atlas Search pipeline stages, see :atlas:`Choose the
-Aggregation Pipeline Stage </atlas-search/query-syntax/>` in the Atlas
-documentation.
-
-Create a Pipeline Search Stage
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-You can create the search criteria in your Atlas Search pipeline stage
-by using Search operators.
-
-.. sharedinclude:: dbx/jvm/atlas-search-operator-helpers.rst
-
-   .. replacement:: as-idx-link
-
-      the :ref:`kotlin-sync-atlas-search-index` guide
-
-   .. replacement:: atlas-query-operators-example
-
-      .. io-code-block::
-
-         .. input:: /includes/aggregation/aggregation.kt
-            :language: kotlin
-            :start-after: // start-atlas-searchoperator-helpers
-            :end-before: // end-atlas-searchoperator-helpers
-            :dedent:
-
-         .. output::
-            :language: console
-            :visible: false
-
-            Document{{_id=..., genres=[Comedy, Romance], title=Love at First Bite, year=1979}}
-            Document{{_id=..., genres=[Comedy, Drama], title=Love Affair, year=1994}}
+To learn more about Atlas Search pipeline stages, see :atlas:`Choose the Aggregation
+Pipeline Stage </atlas-search/query-syntax/>` in the Atlas documentation. To view
+examples that use the {+driver-short+} to create Atlas Search pipeline search stages, see
+the :ref:`kotlin-sync-atlas-search` guide.
 
 Additional Information
 ----------------------

source/api.txt

@@ -1,3 +1,6 @@
+.. meta::
+   :robots: noindex, nosnippet 
+
 .. _kotlin-sync-api-docs:
 
 =================

source/atlas-search.txt

@@ -0,0 +1,157 @@
+.. _kotlin-sync-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 examples in this guide use 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. To learn more about
+aggregation operations and builders, see the :ref:`kotlin-sync-aggregation` guide. 
+
+Run an Atlas Search Query
+-------------------------
+
+This section shows how to create an aggregation pipeline to run an
+Atlas Search query on a collection. You can use the ``Aggregates.search()`` builder
+method to create a ``$search`` pipeline stage, which specifies the search
+criteria. Then, call the ``aggregate()`` method and pass your pipeline as a
+parameter.
+
+.. note:: Only Available on Atlas for MongoDB v4.2 and later
+
+   This aggregation pipeline operator is only available for collections hosted
+   on :atlas:`MongoDB Atlas </>` clusters running v4.2 or later that are
+   covered by an :atlas:`Atlas Search index </reference/atlas-search/index-definitions/>`.
+   Learn more about the required setup and the functionality of this operator
+   from the :atlas:`Atlas Search </atlas-search/>` documentation.
+
+Before running 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:`kotlin-sync-atlas-search-index-create` section in the Indexes guide. 
+
+Atlas Search Example
+~~~~~~~~~~~~~~~~~~~~
+
+This example runs an Atlas Search query by performing the
+following actions:
+
+- Constructs a ``$search`` stage by using the ``Aggregates.search()`` builder method,
+  instructing the driver to query for documents in which the ``title``
+  field contains the word ``"Alabama"``
+
+- Constructs a ``$project`` stage by using the ``Aggregates.project()`` builder method,
+  instructing 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/atlas-search.kt
+      :start-after: begin-atlas-search
+      :end-before: end-atlas-search
+      :language: kotlin
+      :dedent:
+
+   .. output:: 
+      :language: console
+      :visible: false
+
+      {"_id": {"$oid": "..."}, "title": "Alabama Moon"}
+      {"_id": {"$oid": "..."}, "title": "Crazy in Alabama"}
+      {"_id": {"$oid": "..."}, "title": "Sweet Home Alabama"}
+
+Atlas Search Metadata
+---------------------
+
+Use the ``searchMeta()`` method to create a :manual:`$searchMeta
+</reference/operator/aggregation/searchMeta/>` pipeline stage, which returns
+only the metadata from the Atlas full-text search results. 
+
+.. tip:: Only Available on Atlas for MongoDB v4.4.11 and later
+
+   This aggregation pipeline operator is available only
+   on :atlas:`MongoDB Atlas </>` clusters running v4.4.11 and later.
+
+The following example shows the ``near`` metadata for an Atlas Search
+aggregation stage:
+
+.. literalinclude:: /includes/aggregation/search-meta-agg.kt
+   :start-after: // begin atlasSearchMeta
+   :end-before: // end atlasSearchMeta
+   :language: kotlin
+   :dedent:
+
+.. _kotlin-atlas-search-helpers:
+
+Create Pipeline Search Stages
+-----------------------------
+
+.. sharedinclude:: dbx/jvm/atlas-search-operator-helpers.rst
+
+   .. replacement:: as-idx-link
+
+      the :ref:`kotlin-sync-atlas-search-index-create` section of the Indexes guide
+
+   .. replacement:: atlas-query-operators-example
+
+      .. io-code-block::
+
+         .. input:: /includes/aggregation/aggregation.kt
+            :language: kotlin
+            :start-after: // start-atlas-searchoperator-helpers
+            :end-before: // end-atlas-searchoperator-helpers
+            :dedent:
+
+         .. output::
+            :language: console
+            :visible: false
+
+            {"_id": ..., "genres": ["Comedy", "Romance"], "title": "Love at First Bite", "year": 1979}
+            {"_id": ..., "genres": ["Comedy", "Drama"], "title": "Love Affair", "year": 1994}
+
+Additional Information
+----------------------
+
+To learn more about Atlas Search, see :atlas:`Atlas Search </atlas-search/>`
+in the Atlas documentation.
+
+API Documentation
+~~~~~~~~~~~~~~~~~
+
+To learn more about the methods mentioned in this guide, see
+the following API documentation:
+
+- `aggregate() <{+driver-api+}/-mongo-collection/aggregate.html>`__
+- `Aggregates.search() <{+core-api+}/client/model/Aggregates.html#search(com.mongodb.client.model.search.SearchCollector)>`__
+- `Aggregates.searchMeta() <{+core-api+}/client/model/Aggregates.html#searchMeta(com.mongodb.client.model.search.SearchCollector)>`__
+- `Aggregates.project() <{+core-api+}/client/model/Aggregates.html#project(org.bson.conversions.Bson)>`__
+- `SearchOperator <{+core-api+}/client/model/search/SearchOperator.html>`__