edits

Author: norareidy

source/atlas-vector-search.txt

@@ -52,11 +52,17 @@ method accepts the following parameters:
 - ``options``: *(Optional)* A set of options that you can use to configure the
   vector search query
 
-Vector Search Example
-~~~~~~~~~~~~~~~~~~~~~
+Basic Vector Search Example
+~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-The following example performs an Atlas Vector Search query on the ``plot_embedding``
-vector field and prints the ``title`` value of the first five results:
+This example runs an Atlas Vector Search query that performs
+the following actions:
+
+- Queries the ``plot_embedding`` vector field.
+- Limits the results to ``5`` documents.
+- Specifies an Approximate Nearest Neighbor (ANN) vector search that considers
+  ``150`` candidates. To learn more about ANN searches, see :atlas:`ANN Search </atlas-vector-search/vector-search-stage/#ann-search>`
+  in the MongoDB Atlas documentation.
 
 .. io-code-block::
 
@@ -82,9 +88,13 @@ vector field and prints the ``title`` value of the first five results:
    ``Double`` instances. However, we recommend that you use the
    ``BinaryVector`` type to improve storage efficiency.
 
-The following example shows how to run the aggregation and print
-the vector search meta-score from the result of the preceding
-aggregation pipeline:
+Vector Search Score Example
+~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+The following example shows how to run same vector search
+query as the preceding example and print the documents' vector search
+meta-score. This score represents the relevance of each
+document to the query vector:
 
 .. io-code-block::