DOCSP-34174: codewhisperer pt 7 (#326)

* DOCSP-34174: codewhisperer pt 7

* JS typo find

Author: rustagir

source/includes/fundamentals/code-snippets/CRUD/countAndEstimate.go

@@ -1,3 +1,4 @@
+// Counts documents in a collection by using the Go driver
 package main
 
 import (
@@ -58,6 +59,7 @@ func main() {
 	fmt.Printf("Number of documents inserted: %d\n", len(result.InsertedIDs))
 
 	{
+		// Counts documents that match a filter and prints the count
 		// begin count documents
 		filter := bson.D{{"rating", bson.D{{"$lt", 6}}}}
 
@@ -70,6 +72,8 @@ func main() {
 	}
 
 	{
+		// Estimates the total number of documents in a collection and
+		// prints the count
 		// begin est doc count
 		count, err := coll.EstimatedDocumentCount(context.TODO())
 		if err != nil {
@@ -80,6 +84,8 @@ func main() {
 	}
 
 	{
+		// Uses an aggregation pipeline to count the documents in a
+		// collection that match the criteria
 		// begin aggregate count
 		matchStage := bson.D{{"$match", bson.D{{"rating", bson.D{{"$gt", 5}}}}}}
 		countStage := bson.D{{"$count", "total_documents"}}

source/includes/fundamentals/code-snippets/CRUD/cursor.go

@@ -1,3 +1,4 @@
+// Retrieves documents referenced by a cursor by using the Go driver
 package main
 
 import (
@@ -79,6 +80,7 @@ func main() {
 
 	fmt.Println("Cursor.All():")
 	{
+		// Retrieves documents and references them in a cursor
 		// begin cursor def
 		cursor, err := coll.Find(context.TODO(), bson.D{})
 		if err != nil {
@@ -88,6 +90,8 @@ func main() {
 
 		defer cursor.Close(context.TODO())
 
+		// Retrieves all documents from the cursor at once by unpacking
+		// the cursor into a slice and printing the slice
 		// begin cursor all
 		var results []MyStruct
 		if err = cursor.All(context.TODO(), &results); err != nil {
@@ -108,6 +112,8 @@ func main() {
 
 		defer cursor.Close(context.TODO())
 
+		// Retrieves documents from the cursor individually by iterating
+		// through the cursor and printing each document
 		// begin cursor next
 		for cursor.Next(context.TODO()) {
 			var result MyStruct
@@ -131,6 +137,8 @@ func main() {
 
 		defer cursor.Close(context.TODO())
 
+		// Retrieves documents from the tailable cursor individually by iterating
+		// through the cursor and printing each document
 		// begin cursor try next
 		for {
 			if cursor.TryNext(context.TODO()) {

source/includes/fundamentals/code-snippets/CRUD/delete.go

@@ -1,3 +1,4 @@
+// Deletes documents that match a filter by using the Go driver
 package main
 
 import (
@@ -57,10 +58,17 @@ func main() {
 
 	fmt.Println("\nDelete Many:\n")
 	{
+		// Creates a filter to match documents where the "length" value
+		// is greater than 300
 		// begin deleteMany
 		filter := bson.D{{"length", bson.D{{"$gt", 300}}}}
+
+		// Sets options for the delete operation to use the index on the
+		// "_id" field
 		opts := options.Delete().SetHint(bson.D{{"_id", 1}})
 
+		// Deletes matching documents and prints the number of deleted
+		// documents
 		result, err := coll.DeleteMany(context.TODO(), filter, opts)
 		if err != nil {
 			panic(err)

source/includes/fundamentals/code-snippets/CRUD/distinctValues.go

@@ -1,3 +1,4 @@
+// Finds distinct values of a document field by using the Go driver
 package main
 
 import (
@@ -53,6 +54,8 @@ func main() {
 	}
 	fmt.Printf("Number of documents inserted: %d\n", len(result.InsertedIDs))
 
+	// Retrieves and prints distinct values of the "department" field in
+	// documents that match the filter
 	// begin distinct
 	results, err := coll.Distinct(context.TODO(), "department", bson.D{{"enrollment", bson.D{{"$lt", 50}}}})
 	if err != nil {

source/includes/fundamentals/code-snippets/CRUD/insertOptions.go

@@ -1,3 +1,4 @@
+// Sets options for insert operations by using the Go driver
 package main
 
 import (
@@ -15,13 +16,17 @@ type Book struct {
 // end-book-struct
 
 func insertManyOpts() {
+	// Sets options to bypass document validation and specify an
+	// unordered insert when inserting multiple documents
 	// begin insertManyOpts
 	opts := options.InsertMany().SetBypassDocumentValidation(true).SetOrdered(false)
 	// end insertManyOpts
 	fmt.Println(opts)
 }
 
 func insertOneOpts() {
+	// Sets options to bypass document validation when inserting a
+	// single document
 	// begin insertOneOpts
 	opts := options.InsertOne().SetBypassDocumentValidation(true)
 	// end insertOneOpts