updates for version

Author: stephmarie17

source/fundamentals/crud/read-operations.txt

@@ -13,6 +13,7 @@ Read Operations
    Open Change Streams </fundamentals/crud/read-operations/change-streams>
    Search Text </fundamentals/crud/read-operations/text-search>
    Sort Data </fundamentals/crud/read-operations/sort>
+   Skip Results </fundamentals/crud/read-operations/skip>
 
 ..
    /fundamentals/crud/read-operations/count

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

@@ -50,14 +50,6 @@ Skip Documents
 You can skip results retrieved by a query, or you can skip results within an
 aggregation pipeline. 
 
-This section describes how to skip results in the following ways:
-
-- :ref:`skip() method <rust-skip-method>`: Chain the ``skip()`` method to the 
-  ``find()`` method
-- :ref:`FindOptions struct <rust-findoptions-skip>`: Use the ``skip()`` option 
-  builder method to configure a ``FindOptions`` struct
-- :ref:`Aggregation pipleline <rust-aggregation-skip>`: Create a pipeline that uses the ``$skip`` stage
-
 If the number of skipped documents exceeds the number of matched documents for a
 query, then that query returns no documents.
 
@@ -66,14 +58,14 @@ fields. To avoid skipping random documents, use the ``sort()`` method to sort
 documents on a field with a unique value before setting a skip option. To learn
 more, see the :ref:`rust-sort-guide` guide.
 
-.. _rust-skip-method:
+.. _rust-skip-example:
 
-skip() Method Example
-~~~~~~~~~~~~~~~~~~~~~~
+Query Results Example
+~~~~~~~~~~~~~~~~~~~~~
 
-To skip documents, you can chain the ``skip()`` method to the ``find()`` method.
-The ``skip()`` method takes an integer that specifies the number of documents to
-omit from the beginning of the result set. 
+To skip documents, you can initialize a ``FindOptions`` instance and specify the
+number of documents you want to skip using the ``skip()`` option. Then, pass
+your ``FindOptions`` struct as a parameter to the ``find()`` method.
 
 This example runs a ``find()`` operation that performs the following actions:
 
@@ -97,39 +89,6 @@ This example runs a ``find()`` operation that performs the following actions:
       Book { name: "A Dance with Dragons", author: "Martin", length: 1104 }
       Book { name: "Atlas Shrugged", author: "Rand", length: 1088 }
 
-.. _rust-findoptions-skip:
-
-Options Example
-~~~~~~~~~~~~~~~
-
-Alternatively, if you are setting and reusing options for your query, you can
-use ``FindOptions``. Set the ``skip`` field of the ``FindOptions`` struct by
-using the ``skip()`` 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.
-
-This example runs a ``find()`` operation that performs the following actions:
-
-- Sorts the results in descending order of their ``name`` field values
-- Skips the first document
-- Returns the remaining documents
-
-.. io-code-block::
-   :copyable: true
-
-   .. input:: /includes/fundamentals/code-snippets/crud/skip.rs
-      :start-after: start-options-skip-example
-      :end-before: end-options-skip-example
-      :language: rust
-      :dedent:
-
-   .. output::
-      :language: console
-      :visible: false
-
-      Book { name: "Les Misérables", author: "Hugo", length: 1462 }
-      Book { name: "Atlas Shrugged", author: "Rand", length: 1088 }
-
 .. _rust-aggregation-skip:
 
 Aggregation Example
@@ -171,6 +130,7 @@ To learn more about the operations mentioned in this guide, see the following gu
 - :ref:`rust-compound-operations`
 - :ref:`rust-aggregation`
 - :ref:`rust-sort-guide`
+
 .. - :ref:`rust-limit-guide`
 
 API Documentation

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

@@ -1,5 +1,5 @@
 use std::env;
-use mongodb::{ bson::doc, bson::Document, Client, Collection, options::FindOptions };
+use mongodb::{ bson::doc, Client, Collection, options::FindOptions };
 use serde::{Deserialize, Serialize};
 use futures::stream::TryStreamExt;
 
@@ -46,36 +46,22 @@ async fn main() -> mongodb::error::Result<()> {
         },
     ];
 
-    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 "author" field
 // values, and skips the first two results.
 // start-skip-example
-    let mut cursor = my_coll
-        .find(doc! {})
-        .sort(doc! { "author": 1 })
-        .skip(2).await?;
-
-    while let Some(result) = cursor.try_next().await? {
-        println!("{:?}", result);
-    }
-// end-skip-example
-
-// Sets the values for the `FindOptions` struct to sort results by their "name"
-// field values, skip the first two results, and return the remaining results.
-// start-options-skip-example
     let find_options = FindOptions::builder()
-        .sort(doc! { "name": -1 })
-        .skip(1)
+        .sort(doc! { "author": 1 })
+        .skip(2)
         .build();
-
-    let mut cursor = my_coll.find(doc! {}).with_options(find_options).await?;
+    let mut cursor = my_coll.find(doc! {}, find_options).await?;
 
     while let Some(result) = cursor.try_next().await? {
         println!("{:?}", result);
     }
-// end-options-skip-example
+// end-skip-example
 
 // Retrieves documents in the collection, sorts results by their "author" field,
 // then skips the first two results in an aggregation pipeline.
@@ -86,7 +72,7 @@ let pipeline = vec![
     doc! { "$skip": 1 },
 ];
 
-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);