DOCSP-44853: Data modeling in usage examples

Author: norareidy

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

@@ -16,7 +16,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");
 

source/includes/usage-examples/code-snippets/find-one-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");
 

source/usage-examples/findOne.txt

@@ -22,12 +22,16 @@ Example
 -------
 
 This example retrieves a document that matches a query filter from the ``restaurants``
-collection in the ``sample_restaurants`` database. The example populates a ``Restaurant``
-struct with data from the retrieved document.
+collection in the ``sample_restaurants`` database. The ``find_one()`` method returns the
+first document in which the value of the ``name`` field is ``"Tompkins Square Bagels"``.
 
-This example uses a query filter that matches documents in which the value of the
-``name`` field is ``"Tompkins Square Bagels"``. MongoDB retrieves the
-first document that matches the query filter.
+You can model the retrieved document as a BSON data type or a custom data type. To specify
+which data type models 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:
@@ -37,41 +41,59 @@ see the corresponding code for each runtime:
    .. tab:: Asynchronous
       :tabid: find-one-async
 
-      .. io-code-block::
-         :copyable: true
+      .. literalinclude:: /includes/usage-examples/code-snippets/find-one-async.rs
+         :language: rust
+         :emphasize-lines: 19
+         :dedent:
 
-         .. input:: /includes/usage-examples/code-snippets/find-one-async.rs
-            :language: rust
-            :dedent:
+   .. tab:: Synchronous
+      :tabid: find-one-sync
 
-         .. output::
-            :language: console
-            :visible: false
+      .. literalinclude:: /includes/usage-examples/code-snippets/find-one-sync.rs
+         :language: rust
+         :emphasize-lines: 17
+         :dedent:
 
-            Some(
-                Restaurant {
-                    name: "Tompkins Square Bagels",
-                    cuisine: "American",
-                },
-            )
+Output 
+~~~~~~
 
-   .. tab:: Synchronous
-      :tabid: find-one-sync
+Select the :guilabel:`BSON Document Result` or :guilabel:`Restaurant Struct Result` tab to
+see the corresponding code output based on your collection's type parameter:
 
-      .. io-code-block::
-         :copyable: true
+.. tabs::
 
-         .. input:: /includes/usage-examples/code-snippets/find-one-sync.rs
-            :language: rust
-            :dedent:
+   .. tab:: BSON Document Result
+      :tabid: find-one-async
+
+      .. code-block:: none
+         :copyable: false
+
+         Some(
+            Document({
+               "_id": ObjectId(
+                     "...",
+               ),
+
+               ...
+
+               "name": String(
+                     "Tompkins Square Bagels",
+               ),
+               "restaurant_id": String(
+                     "41605054",
+               ),
+            }),
+         )
+
+   .. tab:: Restaurant Struct Result
+      :tabid: find-one-sync
 
-         .. output::
-            :language: console
-            :visible: false
+      .. code-block:: none
+         :copyable: false
 
-            Some(
-                Restaurant {
-                    name: "Tompkins Square Bagels",
-                    cuisine: "American",
-                },
-            )
+         Some(
+            Restaurant {
+               name: "Tompkins Square Bagels",
+               cuisine: "American",
+            },
+         )