DOCSP-26413 Update Insert Many Usage Example Structs (#194)

* DOCSP-26413 Update Insert Many Usage Example Structs

* typo fix

* review edits

Author: ajhuh-mdb

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

@@ -7,11 +7,22 @@ import (
 	"os"
 
 	"github.com/joho/godotenv"
-	"go.mongodb.org/mongo-driver/bson"
 	"go.mongodb.org/mongo-driver/mongo"
 	"go.mongodb.org/mongo-driver/mongo/options"
 )
 
+// start-restaurant-struct
+type Restaurant struct {
+	Name         string
+	RestaurantId string `bson:"restaurant_id,omitempty"`
+	Cuisine      string
+	Address      interface{} `bson:"address,omitempty"`
+	Borough      string
+	Grades       []interface{} `bson:"grades,omitempty"`
+}
+
+// end-restaurant-struct
+
 func main() {
 	if err := godotenv.Load(); err != nil {
 		log.Println("No .env file found")
@@ -33,20 +44,21 @@ func main() {
 	}()
 
 	// begin insertMany
-	coll := client.Database("insertDB").Collection("haikus")
-	docs := []interface{}{
-		bson.D{{"title", "Record of a Shriveled Datum"}, {"text", "No bytes, no problem. Just insert a document, in MongoDB"}},
-		bson.D{{"title", "Showcasing a Blossoming Binary"}, {"text", "Binary data, safely stored with GridFS. Bucket the data"}},
+	coll := client.Database("sample_restaurants").Collection("restaurants")
+	newRestaurants := []interface{}{
+		Restaurant{Name: "Rule of Thirds", Cuisine: "Japanese", Borough: "Brooklyn"},
+		Restaurant{Name: "Soothr", Cuisine: "Thai", Borough: "Manhattan"},
+		Restaurant{Name: "Madame Vo", Cuisine: "Vietnamese", Borough: "Manhattan"},
 	}
 
-	result, err := coll.InsertMany(context.TODO(), docs)
+	result, err := coll.InsertMany(context.TODO(), newRestaurants)
 	if err != nil {
 		panic(err)
 	}
 	// end insertMany
 
 	// When you run this file, it should print:
-	// 2 documents inserted with IDs: ObjectID("..."), ObjectID("...")
+	// 3 documents inserted with IDs: ObjectID("..."), ObjectID("...")
 	fmt.Printf("%d documents inserted with IDs:\n", len(result.InsertedIDs))
 	for _, id := range result.InsertedIDs {
 		fmt.Printf("\t%s\n", id)

source/usage-examples/insertMany.txt

@@ -14,14 +14,28 @@ Example
 
 .. include:: /includes/usage-examples/run-example-tip.rst
 
-The following example inserts two documents in the ``haikus`` collection:
+This example uses the following ``Restaurant`` struct as a model for documents 
+in the ``restaurants`` collection: 
+
+.. literalinclude:: /includes/usage-examples/code-snippets/insertMany.go
+   :start-after: start-restaurant-struct
+   :end-before: end-restaurant-struct
+   :language: go 
+   :copyable: 
+   :dedent:
+
+The ``omitempty`` :ref:`struct tag<golang-struct-tags>` omits the corresponding 
+field from the inserted document when left empty.
+
+The following example inserts three new documents to the ``restaurants`` 
+collection:
 
 .. include:: /includes/fundamentals/automatic-db-coll-creation.rst
 
 .. literalinclude:: /includes/usage-examples/code-snippets/insertMany.go
    :start-after: begin insertMany
    :end-before: end insertMany
-   :emphasize-lines: 7
+   :emphasize-lines: 8
    :language: go
    :dedent:
 
@@ -31,23 +45,32 @@ Expected Result
 ---------------
 
 After you run the full example, you can find the following inserted
-documents in the ``haikus`` collection:
+documents in the ``restaurants`` collection:
 
 .. code-block:: json
    :copyable: false
 
    {
      "_id": ObjectId("..."),
-     "title": "Record of a Shriveled Datum",
-     "text": "No bytes, no problem. Inserting a document. In MongoDB"
+     "name": "Rule of Thirds",
+     "cuisine": "Japanese",
+     "borough": "Brooklyn"
+   },
+   {
+     "_id": ObjectId("..."),
+     "title": "Soothr",
+     "cuisine": "Thai",
+     "borough": "Manhattan"
    },
    {
      "_id": ObjectId("..."),
-     "title": "Showcasing a Blossoming Binary",
-     "text": "Binary data, safely stored with GridFS. Bucket the data"
+     "title": "Madame Vo",
+     "cuisine": "Vietnamese",
+     "borough": "Manhattan"
    }
 
-For an example on how to find multiple documents, see :ref:`golang-find-multiple`.
+For an example on how to find multiple documents, see the 
+:ref:`golang-find-multiple` usage example.
 
 Additional Information
 ----------------------