DOCSP-51818 Standardize replace usage ex

source/crud/update/replace.txt

@@ -120,6 +120,73 @@ and the immutable ``_id`` field as follows:
       "quantity" : 107
    }
 
+Replace One Document Example: Full File
+---------------------------------------
+
+.. include:: /includes/usage-examples/example-intro.rst
+
+This example performs the following actions on the ``restaurants``
+collection:
+
+- Matches a document in which the value of ``name`` is "Rizzo's Fine Pizza"
+- Replaces the matched document with a new document
+
+Select the **Struct** or **bson.D** tab to see the corresponding code:
+
+.. tabs::
+
+   .. tab :: Struct
+      :tabid: structExample
+
+      The following code uses structs to replace a document, in which the value of
+      ``name`` is "Rizzo's Fine Pizza", with a new document:
+
+      .. io-code-block::
+         :copyable: true
+
+         .. input:: /includes/usage-examples/code-snippets/replace.go
+            :language: go
+            :dedent:
+
+         .. output::
+            :language: none
+            :visible: false 
+
+            Number of documents replaced: 1
+
+   .. tab :: bson.D
+      :tabid: bsonDExample
+
+      The following code uses a bson.D type to replace a document, in which the value of
+      ``name`` is "Rizzo's Fine Pizza", with a new document:
+
+      .. io-code-block::
+         :copyable: true
+
+         .. input:: /includes/usage-examples/code-snippets/replaceBsonD.go
+            :language: go
+            :dedent:
+
+         .. output::
+            :language: none
+            :visible: false 
+
+            Number of documents replaced: 1
+
+Expected Result
+~~~~~~~~~~~~~~~
+
+After you run the full example, you can find the following replaced document 
+in the ``restaurants`` collection:
+
+.. code-block:: none
+
+   {
+      "_id" : ObjectId("..."),
+      "name" : "Rizzo's Pizza",
+      "cuisine" : "Pizza/American"
+   }
+
 API Documentation
 -----------------
 

source/includes/usage-examples/code-snippets/replace.go

@@ -8,12 +8,10 @@ import (
 	"os"
 
 	"github.com/joho/godotenv"
-	"go.mongodb.org/mongo-driver/v2/bson"
 	"go.mongodb.org/mongo-driver/v2/mongo"
 	"go.mongodb.org/mongo-driver/v2/mongo/options"
 )
 
-// start-restaurant-struct
 type Restaurant struct {
 	Name         string
 	RestaurantId string        `bson:"restaurant_id,omitempty"`
@@ -23,7 +21,9 @@ type Restaurant struct {
 	Grades       []interface{} `bson:"grades,omitempty"`
 }
 
-// end-restaurant-struct
+type RestaurantNameFilter struct {
+	Name string
+}
 
 func main() {
 	if err := godotenv.Load(); err != nil {
@@ -45,23 +45,21 @@ func main() {
 		}
 	}()
 
-	// begin replace
 	coll := client.Database("sample_restaurants").Collection("restaurants")
-	filter := bson.D{{"name", "Madame Vo"}}
+	filter := RestaurantNameFilter{Name: "Rizzo's Fine Pizza"}
 
 	// Creates a new document containing "Name" and "Cuisine" fields
-	replacement := Restaurant{Name: "Monsieur Vo", Cuisine: "Asian Fusion"}
+	replacement := Restaurant{Name: "Rizzo's Pizza", Cuisine: "Pizza/American"}
 
 	// Replaces the first document that matches the filter with a new document
 	result, err := coll.ReplaceOne(context.TODO(), filter, replacement)
 	if err != nil {
 		panic(err)
 	}
-	// end replace
 
 	// Prints the number of modified documents
 	if result.MatchedCount != 0 {
-		fmt.Println("Number of documents replaced: %d\n", result.ModifiedCount)
+		fmt.Println("Number of documents replaced:", result.ModifiedCount)
 	}
 
 	// When you run this file for the first time, it should print:

source/includes/usage-examples/code-snippets/replaceBsonD.go

@@ -0,0 +1,58 @@
+// Replaces the first document that matches a filter by using the Go driver
+package main
+
+import (
+	"context"
+	"fmt"
+	"log"
+	"os"
+
+	"github.com/joho/godotenv"
+	"go.mongodb.org/mongo-driver/v2/bson"
+	"go.mongodb.org/mongo-driver/v2/mongo"
+	"go.mongodb.org/mongo-driver/v2/mongo/options"
+)
+
+func main() {
+	if err := godotenv.Load(); err != nil {
+		log.Println("No .env file found")
+	}
+
+	var uri string
+	if uri = os.Getenv("MONGODB_URI"); uri == "" {
+		log.Fatal("You must set your 'MONGODB_URI' environment variable. See\n\t https://www.mongodb.com/docs/drivers/go/current/connect/mongoclient/#environment-variable")
+	}
+
+	client, err := mongo.Connect(options.Client().ApplyURI(uri))
+	if err != nil {
+		panic(err)
+	}
+	defer func() {
+		if err = client.Disconnect(context.TODO()); err != nil {
+			panic(err)
+		}
+	}()
+
+	coll := client.Database("sample_restaurants").Collection("restaurants")
+	filter := bson.D{{"name", "Rizzo's Fine Pizza"}}
+
+	// Creates a new document containing "Name" and "Cuisine" fields
+	replacement := bson.D{
+		bson.E{Key: "name", Value: "Rizzo's Pizza"},
+		bson.E{Key: "cuisine", Value: "Pizza/American"},
+	}
+
+	// Replaces the first document that matches the filter with a new document
+	result, err := coll.ReplaceOne(context.TODO(), filter, replacement)
+	if err != nil {
+		panic(err)
+	}
+
+	// Prints the number of modified documents
+	if result.MatchedCount != 0 {
+		fmt.Println("Number of documents replaced:", result.ModifiedCount)
+	}
+
+	// When you run this file for the first time, it should print:
+	// Number of documents replaced: 1
+}