version updates

Author: stephmarie17

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

@@ -60,53 +60,15 @@ Limit Documents
 You can specify the maximum number of documents to return in a query or in an
 aggregation pipeline.
 
-This section describes how to limit results in the following ways:
-
-- :ref:`limit() method <rust-limit-method>`: Chain the ``limit()`` method to the
-  ``find()`` method
-- :ref:`FindOptions struct <rust-findoptions-limit>`: Use the ``limit`` option
-- :ref:`Aggregation pipleline <rust-aggregation-limit>`: Create a pipeline that uses the ``$limit`` stage
-
 .. _rust-limit-method:
 
-limit() Method Example
-~~~~~~~~~~~~~~~~~~~~~~~
+Query Results Example
+~~~~~~~~~~~~~~~~~~~~~
 
-To limit the number of documents returned, you can chain the ``limit()`` method
-to the ``find()`` method.
-
-This example runs a ``find()`` operation that performs the following actions:
-
-- Sorts the results in ascending order of their ``length`` field values
-- Limits the results to the first three documents
-
-.. io-code-block::
-   :copyable: true
-
-   .. input:: /includes/fundamentals/code-snippets/crud/limit.rs
-      :start-after: start-limit-example
-      :end-before: end-limit-example
-      :language: rust
-      :dedent:
-
-   .. output::
-      :language: console
-      :visible: false
-
-      Book { name: "The Brothers Karamazov", author: "Dostoyevsky", length: 824 }
-      Book { name: "Atlas Shrugged", author: "Rand", length: 1088 }
-      Book { name: "A Dance with Dragons", author: "Martin", length: 1104 }
-
-.. _rust-findoptions-limit:
-
-Options Example
-~~~~~~~~~~~~~~~
-
-Alternatively, if you are setting and reusing options for your query, you can
-use ``FindOptions``. Set the ``limit`` field of the ``FindOptions`` struct by
-using the ``limit()`` option builder method. Then, chain the ``with_options()``
-method to the ``find()`` method and pass your ``FindOptions`` struct as a
-parameter to the ``with_options()`` method.
+To limit the number of documents returned, you can initialize a ``FindOptions``
+instance and specify the number of documents you want to limit using the
+``limit()`` method. Then, pass your ``FindOptions`` struct as a parameter to the
+``find()`` method.
 
 This example runs a ``find()`` operation that performs the following actions:
 
@@ -119,8 +81,8 @@ This example runs a ``find()`` operation that performs the following actions:
    :copyable: true
 
    .. input:: /includes/fundamentals/code-snippets/crud/limit.rs
-      :start-after: start-limit-options-example
-      :end-before: end-limit-options-example
+      :start-after: start-limit-example
+      :end-before: end-limit-example
       :language: rust
       :dedent:
 
@@ -158,8 +120,8 @@ This example runs an aggregation pipeline that performs the following actions:
       :language: console
       :visible: false
 
-      Document({"_id": Int32(3), "name": String("Les Misérables"), "author": String("Hugo"), "length": Int32(1462)})
-      Document({"_id": Int32(4), "name": String("A Dance with Dragons"), "author": String("Martin"), "length": Int32(1104)})
+      Document({"_id": ObjectId("..."), "name": String("Les Misérables"), "author": String("Hugo"), "length": Int32(1462)})
+      Document({"_id": ObjectId("..."), "name": String("A Dance with Dragons"), "author": String("Martin"), "length": Int32(1104)})
 
 Additional Information
 ----------------------

source/includes/fundamentals/code-snippets/crud/limit.rs

@@ -21,64 +21,47 @@ async fn main() -> mongodb::error::Result<()> {
 
     let books = vec![
         Book {
-            id: 1,
             name: "The Brothers Karamazov".to_string(),
             author: "Dostoyevsky".to_string(),
             length: 824,
         },
         Book {
-            id: 2,
             name: "Atlas Shrugged".to_string(),
             author: "Rand".to_string(),
             length: 1088,
         },
         Book {
-            id: 3,
             name: "Les Misérables".to_string(),
             author: "Hugo".to_string(),
             length: 1462,
         },
         Book {
-            id: 4,
             name: "A Dance with Dragons".to_string(),
             author: "Martin".to_string(),
             length: 1104,
         },
     ];
 
-    my_coll.insert_many(books).await?;
+    my_coll.insert_many(books, None).await?;
 // end-sample-data
 
-// Retrieves documents in the collection, sorts results by their "length" field
-// values, and limits the results to three documents.
-// start-limit-example
-    let mut cursor = my_coll
-        .find(doc! {})
-        .sort(doc! { "length": 1 })
-        .limit(3).await?;
-
-    while let Some(result) = cursor.try_next().await? {
-    println!("{:?}", result);
-    }
-// end-limit-example
-
 // Filters the results to only include documents where the "length" field value
 // is greater than 1000, then sorts results by their "length" field values, and
 // limits the results to the first two documents.
-// start-limit-options-example
+// start-limit-example
     let filter = doc! { "length": { "$gt": 1000 } };
 
     let find_options = FindOptions::builder()
         .sort(doc! { "length": 1 })
         .limit(2)
         .build();
 
-    let mut cursor = my_coll.find(filter).with_options(find_options).await?;
+    let mut cursor = my_coll.find(filter, find_options).await?;
 
     while let Some(result) = cursor.try_next().await? {
         println!("{:?}", result);
     }
-// end-limit-options-example
+// end-limit-example
 
 // Retrieves documents in the collection, sorts results by their "length" field
 // values, then limits the results to the first document.
@@ -89,7 +72,7 @@ let pipeline = vec![
     doc! { "$limit": 2 },
 ];
 
-let mut cursor = my_coll.aggregate(pipeline).await?;
+let mut cursor = my_coll.aggregate(pipeline, None).await?;
 
 while let Some(result) = cursor.try_next().await? {
     println!("{:?}", result);