DOCSP-30536: Retrieve guide tech review (#37)

Author: norareidy

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

@@ -64,6 +64,13 @@ Find Operations
 Use **find operations** to retrieve data from MongoDB. Find operations
 consist of the ``find()`` and ``find_one()`` methods.
 
+You can also run find operations after starting a session with the
+``find_with_session()`` and ``find_one_with_session()`` methods. Both methods
+take an additional ``ClientSession`` parameter, or a logical session used for
+ordering sequential operations. To learn more about these two methods, see the
+API documentation for `find_with_session() <{+api+}/struct.Collection.html#method.find_with_session>`__
+and `find_one_with_session() <{+api+}/struct.Collection.html#method.find_one_with_session>`__.
+
 Find All Matching Documents
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
@@ -89,8 +96,10 @@ To find *the first document* that matches your criteria, use the
 query filter consists of the fields and values that form criteria for
 documents to match.
 
-If a document matches the filter criteria, the method returns a ``Some``
-type. If it does not match any documents, it returns a ``None`` type.
+If a document matches the filter criteria, the method returns a
+``Result<Option<T>>`` type with a value of ``Some``. If no documents
+match the filter criteria, ``find_one()`` returns a ``Result<Option<T>>``
+type with a value of ``None``.
 
 To see an example that uses this method to retrieve data, see
 the :ref:`find_one() example <rust-find-one-example>`.
@@ -119,17 +128,17 @@ The following table describes commonly used settings that you can specify in
 
    * - ``collation`` 
      - | The collation to use when sorting results.
-       | Default: ``nil``
+       | Default: ``None``
 
    * - ``hint`` 
      - | The index to use for the operation. To learn more about
          indexes, see :manual:`Indexes </indexes/>` in the Server
          manual.
-       | Default: ``nil``
+       | Default: ``None``
 
    * - ``projection`` 
      - | The projection to use when returning results.
-       | Default: ``nil``
+       | Default: ``None``
 
    * - ``read_concern`` 
      - | The read concern to use for the find operation. If you don't
@@ -140,14 +149,14 @@ The following table describes commonly used settings that you can specify in
 
    * - ``skip`` 
      - | The number of documents to skip when returning results.  
-       | Default: ``nil``
+       | Default: ``None``
 
    * - ``sort`` 
      - | The sort to use when returning results. By default, the driver
          returns documents in their natural order, or as they appear in
          the database. To learn more, see :manual:`natural order </reference/glossary/#std-term-natural-order>`
          in the Server manual glossary.
-       | Default: ``nil``
+       | Default: ``None``
 
 .. TODO link to projection fundamentals page under projection setting
 .. TODO link to collation fundamentals page under collations setting
@@ -301,13 +310,13 @@ The following table describes commonly used settings that you can specify in
 
    * - ``collation``
      - | The collation to use when sorting results.
-       | Default: ``nil``
+       | Default: ``None``
 
    * - ``hint`` 
      - | The index to use for the operation. To learn more about
          indexes, see :manual:`Indexes </indexes/>` in the Server
          manual.
-       | Default: ``nil``
+       | Default: ``None``
 
    * - ``read_concern`` 
      - | The read concern to use for the find operation. If you don't

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

@@ -20,7 +20,7 @@ async fn main() -> mongodb::error::Result<()> {
     my_coll.insert_many(docs, None).await?;
 
     // begin-find-many
-    let opts: FindOptions = FindOptions::builder()
+    let opts = FindOptions::builder()
         .sort(doc! { "unit_price": -1 })
         .build();
 
@@ -41,7 +41,7 @@ async fn main() -> mongodb::error::Result<()> {
     print!("\n");
 
     // begin-find-one
-    let opts: FindOneOptions = FindOneOptions::builder().skip(2).build();
+    let opts = FindOneOptions::builder().skip(2).build();
     let result = my_coll.find_one(
         doc! { "unit_price":
             doc! { "$lte": 20.00 } },