RR review

Author: rachel-mack

source/aggregation.txt

@@ -80,39 +80,6 @@ The following limitations apply when using aggregation operations:
    </reference/operator/aggregation/graphLookup/>` stage has a strict
    memory limit of 100 megabytes and ignores the ``allowDiskUse`` option.
 
-.. _kotlin-sync-atlas-search-stage:
-
-Pipelines Stages for Atlas Search
----------------------------------
-
-:atlas:`Atlas Search </atlas-search>` queries take the form of an aggregation pipeline stage. Atlas
-Search provides ``$search`` and ``$searchMeta`` stages, both of which must be the first
-stage in any query pipeline. For more information about Atlas pipeline stages,
-see the :atlas:`Choose the Aggregation Pipeline Stage
-</atlas-search/query-syntax/>` page in the Atlas
-manual. 
-
-.. sharedinclude:: dbx/jvm/atlas-search-operator-helpers.rst
-
-   .. replacement:: atlas-query-operators-example
-
-    .. code-block:: kotlin
-
-        val searchStage: Bson = Aggregates.search(
-            SearchOperator.compound()
-                .filter(
-                    listOf(
-                        SearchOperator.text(fieldPath("genres"), "Drama"),
-                        SearchOperator.phrase(fieldPath("cast"), "sylvester stallone"),
-                        SearchOperator.numberRange(fieldPath("year")).gtLt(1980, 1989),
-                        SearchOperator.wildcard(fieldPath("title"), "Rocky *")
-                    )
-                )
-        )
-
-   .. replacement:: searchoperator-interface-api-docs
-
-    the `SearchOperator Interface API documentation <{+core-api+}/client/model/search/SearchOperator.html>`__
 
 Aggregation Example
 -------------------
@@ -222,6 +189,63 @@ and adds the ``$explain`` stage to output the operation details:
         ...
       }
 
+.. _kotlin-sync-atlas-search-stage:
+
+Atlas Search
+------------
+
+You can perform an :atlas:`Atlas Search </atlas-search>` query by creating an aggregation pipeline
+that contains one of the following pipeline stages: 
+
+- ``$search``
+- ``$searchMeta``
+
+For more information about Atlas pipeline stages, see the :atlas:`Choose the
+Aggregation Pipeline Stage </atlas-search/query-syntax/>` page in the Atlas
+documentation.
+
+Create a Pipeline Search Stage
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+You can build a Atlas Search pipeline stage using search operators.
+
+.. sharedinclude:: dbx/jvm/atlas-search-operator-helpers.rst
+
+   .. replacement:: atlas-query-operators-example
+
+      .. io-code-block::
+
+         .. input:: 
+            :language: kotlin
+
+               val searchStage: Bson = Aggregates.search(
+                     SearchOperator.compound()
+                        .filter(
+                           listOf(
+                                 SearchOperator.text(fieldPath("genres"), "Drama"),
+                                 SearchOperator.phrase(fieldPath("cast"), "sylvester stallone"),
+                                 SearchOperator.numberRange(fieldPath("year")).gtLt(1980, 1989),
+                                 SearchOperator.wildcard(fieldPath("title"), "Rocky *")
+                           )
+                        )
+               )
+
+               val aggregatePipelineStages: List<Bson> = listOf(searchStage, Aggregates.project(projection))
+               val results = collection.aggregate<Document>(aggregatePipelineStages)
+               
+               results.forEach { result -> println(result) }
+
+         .. output::
+            :language: console
+            :visible: false
+
+            Document{{_id=573a1397f29313caabce86db, genres=[Drama, Sport], cast=[Sylvester Stallone, Talia Shire, Burt Young, Carl Weathers], title=Rocky III, year=1982}}
+            Document{{_id=573a1398f29313caabce9af0, genres=[Drama, Sport], cast=[Sylvester Stallone, Talia Shire, Burt Young, Carl Weathers], title=Rocky IV, year=1985}}
+
+   .. replacement:: searchoperator-interface-api-docs
+
+      the `SearchOperator Interface API documentation <{+core-api+}/client/model/search/SearchOperator.html>`__
+
 Additional Information
 ----------------------
 

source/whats-new.txt

@@ -45,7 +45,7 @@ and features:
    .. replacement:: atlas-query-operators
 
       the :ref:`Pipelines Stages for Atlas Search
-      <kotlin-sync-atlas-search-stage>` section
+      <kotlin-sync-atlas-search-stage>` section of the Aggregation guide 
 
 .. _kotlin-sync-version-5.3: