DOCSP-34174: codewhisperer pt 8 (#327)

* DOCSP-34174: codewhisperer pt 8

* MW suggestion

Author: rustagir

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

@@ -1,3 +1,4 @@
+// Inserts a single document describing a restaurant by using the Go driver
 package main
 
 import (
@@ -43,6 +44,7 @@ func main() {
 		}
 	}()
 
+	// Inserts a sample document describing a restaurant into the collection
 	// begin insertOne
 	coll := client.Database("sample_restaurants").Collection("restaurants")
 	newRestaurant := Restaurant{Name: "8282", Cuisine: "Korean"}
@@ -53,7 +55,9 @@ func main() {
 	}
 	// end insertOne
 
+	// Prints the ID of the inserted document
+	fmt.Printf("Document inserted with ID: %s\n", result.InsertedID)
+
 	// When you run this file, it should print:
 	// Document inserted with ID: ObjectID("...")
-	fmt.Printf("Document inserted with ID: %s\n", result.InsertedID)
 }

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

@@ -1,3 +1,4 @@
+// Replaces the first document that matches a filter by using the Go driver
 package main
 
 import (
@@ -47,17 +48,22 @@ func main() {
 	// begin replace
 	coll := client.Database("sample_restaurants").Collection("restaurants")
 	filter := bson.D{{"name", "Madame Vo"}}
+
+	// Creates a new document containing "Name" and "Cuisine" fields
 	replacement := Restaurant{Name: "Monsieur Vo", Cuisine: "Asian Fusion"}
 
+	// 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
 
-	// When you run this file for the first time, it should print:
-	// Number of documents replaced: 1
+	// Prints the number of modified documents
 	if result.MatchedCount != 0 {
 		fmt.Println("Number of documents replaced: %d\n", result.ModifiedCount)
 	}
+
+	// When you run this file for the first time, it should print:
+	// Number of documents replaced: 1
 }

source/includes/usage-examples/code-snippets/struct-tag.go

@@ -1,3 +1,4 @@
+// Specifies struct tags on a struct by using the Go driver
 package main
 
 import (
@@ -14,6 +15,7 @@ import (
 	"go.mongodb.org/mongo-driver/mongo/options"
 )
 
+// Specifies a different name for the "WordCount" field when marshalling
 // begin struct
 type BlogPost struct {
 	Title       string
@@ -57,6 +59,7 @@ func main() {
 		Tags:        []string{"seasons", "gardening", "flower"},
 	}
 
+	// Inserts a document describing a blog post into the collection
 	_, err = coll.InsertOne(context.TODO(), post)
 	if err != nil {
 		panic(err)
@@ -65,6 +68,8 @@ func main() {
 
 	filter := bson.D{{"author", "Sam Lee"}}
 
+	// Retrieves the inserted document and prints it as bson.M to see the
+	// alternate field name for "WordCount"
 	var result bson.M
 	err = coll.FindOne(context.TODO(), filter).Decode(&result)
 	if err != nil {

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

@@ -1,3 +1,4 @@
+// Updates documents that match a query filter by using the Go driver
 package main
 
 import (
@@ -35,15 +36,21 @@ func main() {
 	// begin updatemany
 	coll := client.Database("sample_airbnb").Collection("listingsAndReviews")
 	filter := bson.D{{"address.market", "Sydney"}}
+
+	// Creates instructions to update the values of the "price" field
 	update := bson.D{{"$mul", bson.D{{"price", 1.15}}}}
 
+	// Updates documents in which the value of the "address.market"
+	// field is "Sydney"
 	result, err := coll.UpdateMany(context.TODO(), filter, update)
 	if err != nil {
 		panic(err)
 	}
 	// end updatemany
 
+	// Prints the number of updated documents
+	fmt.Printf("Documents updated: %v\n", result.ModifiedCount)
+
 	// When you run this file for the first time, it should print:
 	// Number of documents replaced: 609
-	fmt.Printf("Documents updated: %v\n", result.ModifiedCount)
 }

source/usage-examples/replaceOne.txt

@@ -36,7 +36,7 @@ collection:
 .. literalinclude:: /includes/usage-examples/code-snippets/replace.go
    :start-after: begin replace
    :end-before: end replace
-   :emphasize-lines: 5
+   :emphasize-lines: 8
    :language: go
    :dedent:
 

source/usage-examples/struct-tagging.txt

@@ -2,8 +2,6 @@
 Use Struct Tags
 ===============
 
-.. default-domain:: mongodb
-
 You can specify the way that the Go Driver converts Go
 structs to :manual:`BSON </reference/bson-types/>` by using struct tags.
 

source/usage-examples/updateMany.txt

@@ -4,8 +4,6 @@
 Update Multiple Documents
 =========================
 
-.. default-domain:: mongodb
-
 You can update multiple documents in a collection by using the ``UpdateMany()``
 method.
 
@@ -23,7 +21,7 @@ The following example performs the following on the
 .. literalinclude:: /includes/usage-examples/code-snippets/updateMany.go
    :start-after: begin updatemany
    :end-before: end updatemany
-   :emphasize-lines: 5
+   :emphasize-lines: 9
    :language: go
    :dedent: