addressing feedback

Author: mayaraman19

source/includes/indexes/indexes.py

@@ -97,13 +97,13 @@
     "fields": [
       {
         "type": "vector",
-        "numDimensions": <numberOfDimensions>,
-        "path": "<fieldToIndex>",
-        "similarity": "euclidean | cosine | dotProduct"
+        "numDimensions": <number of dimensions>,
+        "path": "<field to index>",
+        "similarity":  <select from "euclidean", "cosine", "dotProduct">
       }
     ]
   },
-  name="<nameOfIndex>",
+  name="<index name>",
   type="vectorSearch",
 )
 
@@ -113,7 +113,7 @@
 
 # start-create-search-indexes
 
-index_one = SearchIndexModel(
+search_idx = SearchIndexModel(
     definition ={
         "mappings": {
             "dynamic": True
@@ -122,22 +122,22 @@
     name="my_index",
 )
 
-index_two_vector = SearchIndexModel(
+vector_idx = SearchIndexModel(
   definition={
     "fields": [
       {
         "type": "vector",
-        "numDimensions": <numberOfDimensions>,
-        "path": "<fieldToIndex>",
-        "similarity": "euclidean | cosine | dotProduct"
+        "numDimensions": <number of dimensions>,
+        "path": "<field to index>",
+        "similarity": <select from "euclidean", "cosine", "dotProduct">
       }
     ]
   },
   name="my_vector_index",
   type="vectorSearch",
 )
 
-indexes = [index_one, index_two_vector]
+indexes = [search_idx, vector_idx]
 
 collection.create_search_indexes(models=indexes)
 # end-create-search-indexes
@@ -165,7 +165,7 @@
         {
             "type": "vector",
             "numDimensions": 1536,
-            "path": "<fieldToIndex>",
+            "path": "<field to index>",
             "similarity": "euclidean"
         },
     ]

source/indexes/atlas-search-index.txt

@@ -36,7 +36,7 @@ date, objectId, numeric, string, or UUID values that you want to use to
 pre-filter your data.
 
 You can call the following methods on a collection to manage your Atlas Search
-indexes:
+and vector Search indexes:
 
 - ``create_search_index()``
 - ``create_search_indexes()``
@@ -72,18 +72,18 @@ The following code example shows how to create a single Atlas Search index:
    :end-before: end-create-search-index
 
 The following code example shows how to create a single Atlas Vector Search index
-using the `SearchIndexModel <{+api-root+}pymongo/operations.html#pymongo.operations.SearchIndexModel>`__
+by using the `SearchIndexModel <{+api-root+}pymongo/operations.html#pymongo.operations.SearchIndexModel>`__
 object:
 
 .. literalinclude:: /includes/indexes/indexes.py
    :language: python
    :start-after: start-create-vector-search-index
    :end-before: end-create-vector-search-index
 
-You can use `create_search_indexes() <{+api-root+}pymongo/collection.html#pymongo.collection.Collection.create_search_indexes>`__
-to create multiple indexes. These indexes can be Atlas Search indexes or Atlas
-Vector Search indexes. ``create_search_indexes()`` requires the ``SearchIndexModel``
-object.
+You can use the `create_search_indexes() <{+api-root+}pymongo/collection.html#pymongo.collection.Collection.create_search_indexes>`__
+method to create multiple indexes. These indexes can be Atlas Search or
+Vector Search indexes. The ``create_search_indexes()`` method takes a list of
+``SearchIndexModel`` objects that correspond to each index you want to create.
 
 The following code example shows how to create an Atlas Search index and an Atlas
 Vector Search index:
@@ -100,7 +100,7 @@ List Search Indexes
 
 You can use the
 `list_search_indexes() <{+api-root+}pymongo/collection.html#pymongo.collection.Collection.list_search_indexes>`__
-method to return the Atlas Search indexes and Atlas Vector Search indexes 
+method to get information about the Atlas Search and Vector Search indexes 
 of a collection.
 
 The following code example shows how to print a list of the search indexes of
@@ -119,7 +119,7 @@ Update a Search Index
 
 You can use the
 `update_search_index() <{+api-root+}pymongo/collection.html#pymongo.collection.Collection.update_search_index>`__
-method to update an Atlas Search index or Atlas Vector Search index.
+method to update an Atlas Search or Vector Search index.
 
 The following code example shows how to update an Atlas Search index:
 
@@ -144,7 +144,7 @@ Delete a Search Index
 
 You can use the
 `drop_search_index() <{+api-root+}pymongo/collection.html#pymongo.collection.Collection.drop_search_index>`__
-method to remove an Atlas Search index or Atlas Vector Search index.
+method to remove an Atlas Search or Vector Search index.
 
 The following code shows how to delete a search index from a collection: