DOCSP-35724: documentation

Author: mcmorisi

source/fundamentals/atlas-search.txt

@@ -54,7 +54,7 @@ The following ``Guitar`` class models the documents in this collection.
    {
        public int Id { get; set; }
        public string Make { get; set; }
-       public List<string> Models { get; set; }
+       public List<string> Colors { get; set; }
        public int EstablishedYear { get; set; }
        [BsonElement("in_stock")]
        public bool InStock { get; set; }
@@ -335,6 +335,28 @@ The search returns the following document:
 To learn more about the ``geoWithin`` operator, see the :atlas:`geoWithin </atlas-search/geoWithin>` 
 Atlas guide.
 
+In
+~~
+
+Use the ``In()`` method to search for documents that have field values matching a list
+of specified values.
+
+The following example searches the ``guitars`` collection for documents that have a
+``make`` field value of either ``"Fender"`` or ``"Gibson"``.
+
+.. literalinclude:: /includes/fundamentals/code-examples/atlas-search/AtlasSearchExamples.cs
+   :start-after: // start-in-search
+   :end-before: // end-in-search
+   :language: csharp
+   :dedent:
+
+The search returns the following documents:
+
+.. code-block:: json
+
+   { "_id": 1, "make": "Fender", "description": "...", "establishedYear": 1946, "in_stock": true, "rating": 9 }
+   { "_id": 2, "make": "Gibson", "description": "...", "establishedYear": 1902, "in_stock": true, "rating": 8 }
+
 MoreLikeThis
 ~~~~~~~~~~~~
 

source/includes/fundamentals/code-examples/atlas-search/AtlasSearchExamples.cs

@@ -130,6 +130,17 @@ public static List<Guitar> GeoWithinSearch()
         return result;
     }
 
+    public static List<Guitar> InSearch()
+    {
+        // start-in-search
+        var guitarList = new[] { "Fender", "Gibson" };
+        var result = guitarsCollection.Aggregate()
+            .Search(Builders<Guitar>.Search.In(g => g.Make, guitarList))
+            .ToList();
+        // end-in-search
+        return result;
+    }
+
     public static List<Guitar> MoreLikeThisSearch()
     {
         // start-morelikethis-search