JT tech review 1

Author: rustagir

source/aggregation.txt

@@ -77,7 +77,7 @@ Consider the following limitations when performing aggregation operations:
   and passing the array to the ``MongoDB\Collection::aggregate()`` method.
 
   .. important:: $graphLookup Exception
-  
+
      The :manual:`$graphLookup
      </reference/operator/aggregation/graphLookup/>` stage has a strict
      memory limit of 100 megabytes and ignores the ``allowDiskUse`` option.

source/aggregation/atlas-search.txt

@@ -39,12 +39,7 @@ to perform queries. To learn more about this operator, see the
 :atlas:`$search </atlas-search/aggregation-stages/search/>` reference in
 the Atlas documentation.
 
-.. note::
-
-   You might not be able to use the methods described in this guide for
-   every type of Atlas Search query. For more complex use cases, you can
-   create standard aggregation pipelines. To learn more, see the
-   :ref:`php-aggregation` guide.
+.. note:: Atlas Vector Search
 
    To perform searches on vector embeddings in MongoDB, you can use the
    Atlas Vector Search API. To learn about this feature, see
@@ -63,11 +58,11 @@ Search Aggregation Stage
 Import the following classes into your application to perform Atlas
 Search queries by using the Aggregation Builder:
 
-.. code-block:: php
-    
-   use MongoDB\Builder\Pipeline;
-   use MongoDB\Builder\Search;
-   use MongoDB\Builder\Stage;
+.. literalinclude:: /includes/aggregation/atlas-search.php
+   :language: php
+   :dedent:
+   :start-after: start-imports
+   :end-before: end-imports
 
 To create a ``$search`` stage in your aggregation pipeline, perform the
 following actions:
@@ -84,7 +79,7 @@ The following code demonstrates the template for constructing basic Atlas Search
 queries:
 
 .. code-block:: php
-        
+
    $pipeline = new Pipeline(
        Stage::search(
            /* Atlas Search query specifications
@@ -132,8 +127,9 @@ specifications:
       :language: json
       :visible: false
 
-      {"_id": ...,"borough":"Queens","cuisine":"American","name":"Suite Kitchen",...}
-      {"_id": ...,"borough":"Queens","cuisine":"American","name":"Silver Kitchen",...}
+      {"_id":...,"borough":"Queens","cuisine":"American","name":"Kitchen Door"}
+      {"_id":...,"borough":"Queens","cuisine":"American","name":"Cc Kitchen"}
+      {"_id":...,"borough":"Queens","cuisine":"American","name":"Suite Kitchen"}
       // Results truncated
 
 Autocomplete Query 
@@ -169,9 +165,9 @@ string ``"Lucy"`` on the ``name`` field:
       :language: json
       :visible: false
 
-      {"name":"Lucy'S Asian Kitchen"}
-      {"name":"Lucy'S Cantina Royale"}
+      {"name":"Juicy Lucy"}
       {"name":"Lucy'S Vietnamese Kitchen"}
+      {"name":"Lucy'S Cantina Royale"}
       // Results Truncated
 
 You can also pass the following optional parameters to the ``autocomplete()``

source/aggregation/vector-search.txt

@@ -27,9 +27,9 @@ perform Atlas Vector Search queries by using the :ref:`Aggregation Builder API
 
 .. note:: Deployment Compatibility
 
-     You can use the Atlas Search feature only when
-     you connect to MongoDB Atlas clusters. This feature is not
-     available for self-managed deployments.
+	 You can use the Atlas Search feature only when
+	 you connect to MongoDB Atlas clusters. This feature is not
+	 available for self-managed deployments.
 
 To learn more about Atlas Vector Search, see the :atlas:`Overview
 </atlas-vector-search/vector-search-overview/>` in the
@@ -40,12 +40,7 @@ to perform queries. To learn more about this operator, see the
 </atlas-vector-search/vector-search-stage/#syntax>` reference in the
 Atlas documentation.
 
-.. note::
-
-   You might not be able to use the methods described in this guide for
-   every type of Atlas Vector Search query. For more complex use cases, you can
-   create standard aggregation pipelines. To learn more, see the
-   :ref:`php-aggregation` guide.
+.. note:: Atlas Search
 
    To perform advanced full-text search on your documents, you can use the
    Atlas Search API. To learn about this feature, see the
@@ -64,11 +59,11 @@ Vector Search Aggregation Stage
 Import the following classes into your application to perform Atlas
 Search queries by using the Aggregation Builder:
 
-.. code-block:: php
-
-   use MongoDB\Builder\Pipeline;
-   use MongoDB\Builder\Query;
-   use MongoDB\Builder\Stage;
+.. literalinclude:: /includes/aggregation/vector-search.php
+   :language: php
+   :dedent:
+   :start-after: start-imports
+   :end-before: end-imports
 
 To create a ``$vectorSearch`` stage in your aggregation pipeline, perform the
 following actions:
@@ -87,11 +82,11 @@ queries:
 .. code-block:: php
 
    $pipeline = new Pipeline(
-       Stage::vectorSearch(
-           /* Atlas Vector Search query specifications
-           index: '<index name>',
-           path: '<path to embeddings>', ...*/
-       ),
+	   Stage::vectorSearch(
+		   /* Atlas Vector Search query specifications
+		   index: '<index name>',
+		   path: '<path to embeddings>', ...*/
+	   ),
    );
 
 You must pass the following parameters to the ``vectorSearch()`` method:
@@ -100,24 +95,24 @@ You must pass the following parameters to the ``vectorSearch()`` method:
    :header-rows: 1
 
    * - Parameter
-     - Type
-     - Description
+	 - Type
+	 - Description
 
    * - ``index``
-     - ``string``
-     - Name of the vector search index
+	 - ``string``
+	 - Name of the vector search index
 
    * - ``path``
-     - ``array`` or ``string``
-     - Field that stores vector embeddings
+	 - ``array`` or ``string``
+	 - Field that stores vector embeddings
 
    * - ``queryVector``
-     - ``array``
-     - Vector representation of your query
+	 - ``array``
+	 - Vector representation of your query
 
    * - ``limit``
-     - ``int``
-     - Number of results to return
+	 - ``int``
+	 - Number of results to return
 
 Atlas Search Query Examples
 ---------------------------
@@ -127,6 +122,16 @@ Search queries by using the Aggregation Builder. The examples in this
 section use sample data from the ``sample_mflix.embedded_movies``
 collection.
 
+.. note:: Query Vector Length
+	
+   For demonstrative purposes, the examples in this section use
+   sample query vectors that contain very few elements, compared to 
+   the query vector you might use in a runnable application. To view an
+   example that contains the full-length query vector, see the
+   :ref:`Atlas Vector Search Quick Start </atlas-vector-search/tutorials/vector-search-quick-start/>`
+   and select :guilabel:`PHP` from the :guilabel:`Select your language` dropdown in the upper-right
+   corner of the page.
+
 Basic Vector Search Query
 ~~~~~~~~~~~~~~~~~~~~~~~~~
 
@@ -137,19 +142,19 @@ The following code performs an Atlas Vector Search query on the
    :copyable: true
 
    .. input:: /includes/aggregation/vector-search.php
-      :language: php
-      :dedent:
-      :start-after: start-basic-query
-      :end-before: end-basic-query
+	  :language: php
+	  :dedent:
+	  :start-after: start-basic-query
+	  :end-before: end-basic-query
 
    .. output::
-      :language: json
-      :visible: false
+	  :language: json
+	  :visible: false
 
-      {"_id": ...,"title":"About Time",...}
-      {"_id": ...,"title":"Tomorrowland",...}
-      {"_id": ...,"title":"Timecop",...}
-      // Results truncated
+	  {"title":"Thrill Seekers"}
+	  {"title":"About Time"}
+	  {"title":"Timecop"}
+	  // Results truncated
 
 Vector Search Score
 ~~~~~~~~~~~~~~~~~~~
@@ -162,19 +167,19 @@ field, which describes how well the document matches the query vector:
    :copyable: true
 
    .. input:: /includes/aggregation/vector-search.php
-      :language: php
-      :dedent:
-      :start-after: start-score-query
-      :end-before: end-score-query
+	  :language: php
+	  :dedent:
+	  :start-after: start-score-query
+	  :end-before: end-score-query
 
    .. output::
-      :language: json
-      :visible: false
+	  :language: json
+	  :visible: false
 
-      {"title":"About Time","score":0.7843604683876038}
-      {"title":"Timecop","score":0.7771612405776978}
-      {"title":"Tomorrowland","score":0.7669923901557922}
-      // Results truncated
+	  {"title":"Thrill Seekers","score":0.927734375}
+	  {"title":"About Time","score":0.925750732421875}
+	  {"title":"Timecop","score":0.9241180419921875}
+	  // Results truncated
 
 Vector Search Options
 ~~~~~~~~~~~~~~~~~~~~~
@@ -187,26 +192,26 @@ following optional parameters to ``vectorSearch()``:
    :header-rows: 1
 
    * - Optional Parameter
-     - Type
-     - Description
-     - Default Value
+	 - Type
+	 - Description
+	 - Default Value
 
    * - ``exact``
-     - ``bool``
-     - Specifies whether to run an Exact Nearest Neighbor (``true``) or
-       Approximate Nearest Neighbor (``false``) search
-     - ``false``
+	 - ``bool``
+	 - Specifies whether to run an Exact Nearest Neighbor (``true``) or
+	   Approximate Nearest Neighbor (``false``) search
+	 - ``false``
 
    * - ``filter``
-     - ``QueryInterface`` or ``array``
-     - Specifies a pre-filter for documents to search on
-     - no filtering
+	 - ``QueryInterface`` or ``array``
+	 - Specifies a pre-filter for documents to search on
+	 - no filtering
 
    * - ``numCandidates``
-     - ``int`` or ``null``
-     - Specifies the number of nearest neighbors to use during the
-       search
-     - ``null``
+	 - ``int`` or ``null``
+	 - Specifies the number of nearest neighbors to use during the
+	   search
+	 - ``null``
 
 To learn more about these parameters, see the :atlas:`Fields
 </atlas-vector-search/vector-search-stage/#fields>` section of the