DOCSP-44967: Data modeling in update examples

Author: norareidy

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

@@ -5,12 +5,20 @@ use mongodb::{
     Collection
 };
 
+#[derive(Serialize, Deserialize, Debug)]
+struct Restaurant {
+    name: String,
+    price: String,
+}
+
 #[tokio::main]
 async fn main() -> mongodb::error::Result<()> {
     let uri = "<connection string>";
 
     let client = Client::with_uri_str(uri).await?;
-    let my_coll: Collection<Document> = 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/update-one-sync.rs

@@ -4,11 +4,19 @@ use mongodb::{
     sync::{ Client, Collection }
 };
 
+#[derive(Serialize, Deserialize, Debug)]
+struct Restaurant {
+    name: String,
+    price: String,
+}
+
 fn main() -> mongodb::error::Result<()> {
     let uri = "<connection string>";
 
     let client = Client::with_uri_str(uri)?;
-    let my_coll: Collection<Document> = client
+
+    // Replace <T> with the <Document> or <Restaurant> type parameter
+    let my_coll: Collection<T> = client
         .database("sample_restaurants")
         .collection("restaurants");
 

source/usage-examples/updateOne.txt

@@ -4,6 +4,19 @@
 Update a Document
 =================
 
+.. facet::
+   :name: genre
+   :values: reference
+
+.. meta::
+   :keywords: modify, code example
+
+.. contents:: On this page
+   :local:
+   :backlinks: none
+   :depth: 2
+   :class: singlecol
+
 You can update a document in a collection by calling the `update_one()
 <{+api+}/struct.Collection.html#method.update_one>`__ method on a
 ``Collection`` instance.
@@ -26,11 +39,18 @@ Example
 -------
 
 This example updates a document in the ``restaurants`` collection of
-the ``sample_restaurants`` database.
+the ``sample_restaurants`` database. The ``update_one()`` method adds
+the ``price`` field to the first document in which the value of the ``name``
+field is ``"Spice Market"``.
+
+You can access the documents in the ``restaurants`` collection as instances
+of the 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:
 
-The following code adds the ``price`` field to a document in which the
-value of the ``name`` field is ``"Spice Market"``. MongoDB
-updates the first document that matches the query filter.
+- ``<Document>``: Accesses collection documents as BSON documents
+- ``<Restaurant>``: Accesses 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:
@@ -45,6 +65,7 @@ see the corresponding code for each runtime:
 
          .. input:: /includes/usage-examples/code-snippets/update-one-async.rs
             :language: rust
+            :emphasize-lines: 21
             :dedent:
 
          .. output::
@@ -61,6 +82,7 @@ see the corresponding code for each runtime:
 
          .. input:: /includes/usage-examples/code-snippets/update-one-sync.rs
             :language: rust
+            :emphasize-lines: 19
             :dedent:
 
          .. output::