move usage example and add to guide

Author: stephmarie17

source/crud/bulk.txt

@@ -385,6 +385,31 @@ the bulk operation:
    {"title":"Middlemarch","author":"George Eliot","length":904}
    {"title":"Pale Fire","author":"Vladimir Nabokov","length":246}
 
+Bulk Operation Example: Full File
+---------------------------------
+
+.. include:: /includes/usage-examples/example-intro.rst
+
+The following example is a fully runnable file that performs the following actions:
+
+- Matches a document in which the ``name`` field value is ``"Cafe Tomato"`` and
+  replaces it with a new document
+- Matches a document in which the ``name`` field value is ``"Cafe Zucchini"``
+  and updates the value to ``"Zucchini Land"``
+
+.. io-code-block::
+   :copyable: true
+
+   .. input:: /includes/usage-examples/code-snippets/bulk.go
+      :language: go
+      :dedent:
+
+   .. output::
+      :language: none
+
+      Number of documents matched: 2
+      Number of documents modified: 2
+
 .. _golang-bulk-client:
 
 Client Bulk Write
@@ -747,12 +772,6 @@ The following example performs the following actions in any order:
 Additional Information
 ----------------------
 
-For a runnable example on performing a bulk operation, see
-:ref:`golang-bulk-ops-usage-example`.
-
-Related Operations
-~~~~~~~~~~~~~~~~~~
-
 To learn more about performing the operations mentioned, see the
 following guides:
 

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

@@ -13,7 +13,7 @@ import (
 	"go.mongodb.org/mongo-driver/v2/mongo/options"
 )
 
-// start-restaurant-struct
+// Defines a Restaurant struct as a model for documents in the "restaurants" collection
 type Restaurant struct {
 	Name         string
 	RestaurantId string        `bson:"restaurant_id,omitempty"`
@@ -23,8 +23,6 @@ type Restaurant struct {
 	Grades       []interface{} `bson:"grades,omitempty"`
 }
 
-// end-restaurant-struct
-
 func main() {
 	if err := godotenv.Load(); err != nil {
 		log.Println("No .env file found")
@@ -45,7 +43,6 @@ func main() {
 		}
 	}()
 
-	// begin bulk
 	coll := client.Database("sample_restaurants").Collection("restaurants")
 
 	// Creates write models that specify replace and update operations
@@ -61,13 +58,12 @@ func main() {
 
 	// Runs a bulk write operation for the specified write operations
 	results, err := coll.BulkWrite(context.TODO(), models, opts)
-	// end bulk
 
 	if err != nil {
 		panic(err)
 	}
 
-	// When you run this file for the first time, it should print:
+	// When you run this file for the first time, it should print output similar to the following:
 	// Number of documents replaced or modified: 2
 	fmt.Printf("Number of documents replaced or modified: %d", results.ModifiedCount)
 }