LM PR fixes 1

Author: rustagir

source/api.txt

@@ -0,0 +1,13 @@
+=================
+API Documentation
+=================
+
+.. toctree::
+   :titlesonly:
+   :maxdepth: 1
+
+   {+driver-long+} <{+api+}/index.html>
+   BSON Crate <{+bson-api+}/index.html>
+
+- `{+driver-long+} <{+api+}/index.html>`__
+- `BSON Crate <{+bson-api+}/index.html>`__

source/fundamentals/aggregation/vector-search.txt

@@ -99,11 +99,13 @@ tutorial in the Atlas documentation.
 
    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
+   the query vector you use in a runnable application.
+   
+   To view an example that contains the full-length query vector, see the
    :atlas:`Atlas Vector Search Quick Start </atlas-vector-search/tutorials/vector-search-quick-start/>`
-   and select :guilabel:`Rust` from the :guilabel:`Select your language` dropdown in the upper-right
-   corner of the page.
+   and select :guilabel:`Rust` from the :guilabel:`Select your language`
+   dropdown in the upper-right corner of the page. Then, copy the query
+   vector and replace the vector in the following examples.
 
 Basic Vector Search Query
 ~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -173,6 +175,7 @@ Vector Search queries. Depending on your desired query, you can specify the
 following options in the stage definition:
 
 .. list-table::
+   :widths: 20 20 40 20
    :header-rows: 1
 
    * - Optional Parameter
@@ -200,3 +203,28 @@ following options in the stage definition:
 To learn more about these parameters, see the :atlas:`Fields
 </atlas-vector-search/vector-search-stage/#fields>` section of the
 ``$vectorSearch`` operator reference in the Atlas documentation.
+
+.. _rust-avs-addtl-info:
+
+Additional Information
+----------------------
+
+To learn more about the concepts mentioned in this guide, see the
+following Server manual entries:
+
+- :atlas:`Run Vector Search Queries </atlas-vector-search/vector-search-stage/>`
+- :manual:`Aggregation Pipeline </core/aggregation-pipeline/>`
+- :manual:`Aggregation Stages </meta/aggregation-quick-reference/#stages>`
+
+To learn more about the behavior of the ``aggregate()`` method, see the
+:ref:`Aggregation Operations <rust-retrieve-aggregation>` section of the
+Retrieve Data guide.
+
+API Documentation
+~~~~~~~~~~~~~~~~~
+
+To learn more about the methods and types mentioned in this
+guide, see the following API documentation:
+
+- `aggregate() <{+api+}/struct.Collection.html#method.aggregate>`__
+- `Vector <{+bson-api+}/binary/enum.Vector.html>`__

source/fundamentals/crud/read-operations/retrieve.txt

@@ -394,6 +394,7 @@ following documentation:
 - :ref:`rust-sort-guide` guide
 - :ref:`rust-skip-guide` guide
 - :ref:`rust-limit-guide` guide
+
 .. - :ref:`rust-project-guide`
 .. - :ref:`rust-collations-guide`
 
@@ -409,4 +410,4 @@ guide, see the following API documentation:
 - `FindOneOptions <{+api+}/options/struct.FindOneOptions.html>`__
 - `Cursor <{+api+}/struct.Cursor.html>`__
 - `aggregate() <{+api+}/struct.Collection.html#method.aggregate>`__
-- `AggregateOptions <{+api+}/options/struct.AggregateOptions.html>`__
+- `AggregateOptions <{+api+}/options/struct.AggregateOptions.html>`__

source/fundamentals/serialization.txt

@@ -31,7 +31,7 @@ from the **Serde framework**.
 
 By implementing functionality from the ``serde`` crate into your
 application, you can use custom Rust types such as structs and enums
-to model your data and Rust data types to model your field values.
+to model your data.
 
 This guide includes the following sections:
 
@@ -93,7 +93,9 @@ the ``serde`` serialization traits:
 .. tip:: Vector Type
 
    Starting in ``bson`` library v2.14, you can use the
-   ``bson::binary::Vector`` type to represent vectors of numeric values.
+   `bson::binary::Vector <{+bson-api+}/binary/enum.Vector.html>`__ type
+   to represent vectors of numeric values.
+
    Since this type is serialized as a BSON binary vector, usage of
    ``Vector`` can improve storage efficiency. To learn more, see the
    `BSON specification <https://bsonspec.org/spec.html>`__.
@@ -339,6 +341,7 @@ To learn more about the methods and types mentioned in this
 guide, see the following API documentation:
 
 - `collection() <{+api+}/struct.Database.html#method.collection>`__
+- `Vector <{+bson-api+}/binary/enum.Vector.html>`__
 - `clone_with_type() <{+api+}/struct.Collection.html#method.clone_with_type>`__
 - `serialize_with <https://serde.rs/field-attrs.html#serialize_with>`__
   Serde attribute

source/includes/fundamentals/code-snippets/aggregation/vector-search.rs

@@ -23,6 +23,8 @@ async fn main() -> mongodb::error::Result<()> {
         .collection("embedded_movies");
 
     // start-basic-query
+    // Replace this query vector with the 1536-element vector in the
+    // Atlas documentation example
     let query_vector = Vector::Float32(vec![-0.0016261312, -0.028070757, -0.011342932]);
     let pipeline = vec![
         doc! {

source/index.txt

@@ -11,7 +11,7 @@
    What's New </whats-new>
    CRUD Examples </usage-examples>
    Fundamentals </fundamentals>
-   API Documentation <{+api+}/>
+   API Documentation </api>
    FAQ </faq>
    Connection Troubleshooting </connection-troubleshooting>
    Operation Error Handling </op-error-handling>