atlas searchoperation helper methods

Author: rachel-mack

source/fundamentals/aggregation.txt

@@ -215,10 +215,49 @@ first element in the ``categories`` field.
       Results(name=456 Cookies Shop, firstCategory=Bakery)
       Results(name=XYZ Steak Buffet, firstCategory=Steak)
 
+.. _kotlin-cr-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+}/com/mongodb/client/model/search/SearchOperator.html>`__
+
+API Documentation
+-----------------
+
 For more information about the methods and classes mentioned in this section,
 see the following API Documentation:
 
 - `Accumulators <{+core-api+}/client/model/Accumulators.html>`__
 - `$group <{+core-api+}/client/model/Aggregates.html#group(TExpression,java.util.List)>`__
 - `$project <{+core-api+}/client/model/Aggregates.html#project(org.bson.conversions.Bson)>`__
 - `Projections <{+core-api+}/client/model/Projections.html>`__
+- `SearchOperator Interface <{+core-api+}/com/mongodb/client/model/search/SearchOperator.html>`__

source/whats-new.txt

@@ -49,6 +49,11 @@ and features:
       the `SearchOperator <{+core-api+}/client/model/search/SearchOperator.html>`__
       interface API documentation
 
+   .. replacement:: atlas-query-operators
+
+      the :ref:`Pipelines Stages for Atlas Search
+      <kotlin-cr-atlas-search-stage>` section 
+
 .. _kotlin-coroutine-version-5.3:
 
 What's New in 5.3