find multiple

Author: norareidy

source/includes/usage-examples/code-snippets/find-async.rs

@@ -17,7 +17,8 @@ async fn main() -> mongodb::error::Result<()> {
     let uri = "<connection string>";
     let client = Client::with_uri_str(uri).await?;
 
-    let my_coll: Collection<Restaurant> = client
+    // Replace <T> with the <Document> or <Restaurant> type parameter
+    let my_coll: Collection<T> = client
         .database("sample_restaurants")
         .collection("restaurants");
 
@@ -26,7 +27,7 @@ async fn main() -> mongodb::error::Result<()> {
     ).await?;
 
     while let Some(doc) = cursor.try_next().await? {
-        println!("{:?}", doc);
+        println!("{:#?}", doc);
     }
 
     Ok(())

source/includes/usage-examples/code-snippets/find-sync.rs

@@ -14,7 +14,8 @@ fn main() -> mongodb::error::Result<()> {
     let uri = "<connection string>";
     let client = Client::with_uri_str(uri)?;
 
-    let my_coll: Collection<Restaurant> = client
+    // Replace <T> with the <Document> or <Restaurant> type parameter
+    let my_coll: Collection<T> = client
         .database("sample_restaurants")
         .collection("restaurants");
 
@@ -23,7 +24,7 @@ fn main() -> mongodb::error::Result<()> {
     ).run()?;
 
     for result in cursor {
-        println!("{:?}", result?);
+        println!("{:#?}", result?);
       }
 
     Ok(())

source/usage-examples/find.txt

@@ -4,6 +4,19 @@
 Find Multiple Documents
 =======================
 
+.. facet::
+   :name: genre
+   :values: reference
+
+.. meta::
+   :keywords: read, code example
+
+.. contents:: On this page
+   :local:
+   :backlinks: none
+   :depth: 2
+   :class: singlecol
+
 You can query for multiple documents in a collection by calling the
 `find() <{+api+}/struct.Collection.html#method.find>`__ method on a
 ``Collection`` instance.
@@ -26,54 +39,94 @@ Example
 -------
 
 This example retrieves documents that match a query filter from the ``restaurants``
-collection in the ``sample_restaurants`` database. The example populates
-instances of the ``Restaurant`` struct with data from the retrieved
-documents.
+collection in the ``sample_restaurants`` database. The ``find()`` method returns
+all documents in which the value of the ``cuisine`` field is ``"French"``.
 
-The following code uses a query filter that matches documents in which the value
-of the ``cuisine`` field is ``"French"``.
+You can model each retrieved document as a BSON data type or a custom data type. To specify
+which data type represents the collection's data, replace the ``<T>`` type parameter on the
+highlighted line with one of the following values:
+
+- ``<Document>``: Retrieves and prints collection documents as BSON documents
+- ``<Restaurant>``: Retrieves and prints collection documents as instances of the ``Restaurant``
+  struct, defined at the top of the code
 
 Select the :guilabel:`Asynchronous` or :guilabel:`Synchronous` tab to
 see the corresponding code for each runtime:
 
 .. tabs::
 
    .. tab:: Asynchronous
-      :tabid: find-async
-
-      .. io-code-block::
-         :copyable: true
+      :tabid: find-one-async
 
-         .. input:: /includes/usage-examples/code-snippets/find-async.rs
-            :language: rust
-            :dedent:
-
-         .. output::
-            :language: console
-            :visible: false
-
-            // Results truncated
-            ...
-            Restaurant { name: "Cafe Un Deux Trois", cuisine: "French" }
-            Restaurant { name: "Calliope", cuisine: "French" }
-            ...
+      .. literalinclude:: /includes/usage-examples/code-snippets/find-async.rs
+         :language: rust
+         :emphasize-lines: 22
+         :dedent:
 
    .. tab:: Synchronous
-      :tabid: find-sync
+      :tabid: find-one-sync
 
-      .. io-code-block::
-         :copyable: true
+      .. literalinclude:: /includes/usage-examples/code-snippets/find-sync.rs
+         :language: rust
+         :emphasize-lines: 19
+         :dedent:
 
-         .. input:: /includes/usage-examples/code-snippets/find-sync.rs
-            :language: rust
-            :dedent:
+Output 
+~~~~~~
 
-         .. output::
-            :language: console
-            :visible: false
+Select the :guilabel:`BSON Document Results` or :guilabel:`Restaurant Struct Results` tab to
+see the corresponding code output based on your collection's type parameter:
+
+.. tabs::
 
-            // Results truncated
-            ...
-            Restaurant { name: "Cafe Un Deux Trois", cuisine: "French" }
-            Restaurant { name: "Calliope", cuisine: "French" }
-            ...
+   .. tab:: BSON Document Results
+      :tabid: find-one-async
+
+      .. code-block:: none
+         :copyable: false
+
+         ...
+         Some(
+            Document({
+               "_id": ObjectId(
+                     "...",
+               ),
+
+               ...
+
+               "name": String(
+                     "Cafe Un Deux Trois",
+               ),
+               "restaurant_id": String(
+                     "40369461",
+               ),
+            }),
+         ),
+         Some(
+            Document({
+               "_id": ObjectId(
+                     "...",
+               ),
+
+               ...
+
+               "name": String(
+                     "Calliope",
+               ),
+               "restaurant_id": String(
+                     "41665122",
+               ),
+            }),
+         )
+         ...
+
+   .. tab:: Restaurant Struct Results
+      :tabid: find-one-sync
+
+      .. code-block:: none
+         :copyable: false
+
+         ...
+         Restaurant { name: "Cafe Un Deux Trois", cuisine: "French" }
+         Restaurant { name: "Calliope", cuisine: "French" }
+         ...