[C#] CodeWhisperer Code Comments - Part 6 (#158)

* Codewhisperer comments p6

Author: rachel-mack

source/includes/fundamentals/code-examples/builders.cs

@@ -12,25 +12,41 @@ public static void Main(string[] args)
     {
         Setup();
 
-        // Sample builders definitions
+        // Creates a filter for all documents with a "season" value of "Spring"
         var filter = Builders<Flower>.Filter.AnyEq(flower => flower.Season, "spring");
+
+        // Creates a projection to include the "name" and "price" fields, while
+        // excluding the "id" field
         var projection = Builders<Flower>.Projection.Include("Name").Include("Price").Exclude("Id");
+
+        // Creates instructions to sort results by ascending price and to sort 
+        // results with the same price in descending category order
         var sort = Builders<Flower>.Sort.Ascending("Price").Descending("Category");
 
         Console.WriteLine("Finding documents...");
+
+        // Finds all documents that match the filter and applies the specified 
+        // projection and sort to the results
         var result = _flowerCollection.Find(filter).Sort(sort).Project(projection).toList();
 
         Console.WriteLine(result.ToJson());
 
+        // Creates an update object for that will multiply the price value by
+        // 0.9
         var update = Builders<Flower>.Update.Mul("Price", 0.9);
+
+        // Applies the update object instructions to the first document that
+        // matches the filter
         var result2 = _flowerCollection.UpdateOne(filter, update);
     }
 
     private static void Setup()
     {
-        // Establish the connection to MongoDB and get the restaurants database
+        // Establishes the connection to MongoDB and gets the "plants" database
         var mongoClient = new MongoClient(_mongoConnectionString);
         var myDatabase = mongoClient.GetDatabase("plants");
+
+        // Creates a reference to the "flowers" collection
         _flowerCollection = myDatabase.GetCollection<Flower>("flowers");
     }
 }

source/includes/fundamentals/code-examples/specify-query/FindAndBuilder.cs

@@ -1,8 +1,13 @@
+// Creates a filter for all documents with an "establishedYear" value greater
+// than 1985 and a "make" value that does not equal "Kiesel"
 var builder = Builders<Guitar>.Filter;
 var filter = builder.And(builder.Gte(g => g.EstablishedYear, 1985), builder.Ne(r => r.Make, "Kiesel"));
+
+// Finds all documents that match the filter
 var result = _guitarsCollection.Find(filter).ToList();
 
 foreach (var doc in result)
 {
+    // Prints the documents in bson (json) format
     Console.WriteLine(doc.ToBsonDocument());
 }

source/includes/fundamentals/code-examples/specify-query/FindEqBuilder.cs

@@ -1,7 +1,11 @@
+// Creates a filter for all documents with a "make" value of "Fender"
 var filter = Builders<Guitar>.Filter.Eq(g => g.Make, "Fender");
+
+// Finds all documents that match the filter
 var result = _guitarsCollection.Find(filter).ToList();
 
 foreach (var doc in result)
 {
+    // Prints the documents in bson (json) format
     Console.WriteLine(doc.ToBsonDocument());
 }

source/includes/fundamentals/code-examples/specify-query/FindExistsBuilder.cs

@@ -1,7 +1,11 @@
+// Creates a filter for all documents with a populated "ratings" field
 var filter = Builders<Guitar>.Filter.Exists(g => g.Rating);
+
+// Finds all documents that match the filter
 var result = _guitarsCollection.Find(filter).ToList();
 
 foreach (var doc in result)
 {
+    // Prints the documents in bson (json) format
     Console.WriteLine(doc.ToBsonDocument());
 }

source/includes/fundamentals/code-examples/specify-query/FindGtBuilder.cs

@@ -1,7 +1,12 @@
+// Creates a filter for all documents with an "establishedYear" value greater
+// than 1985
 var filter = Builders<Guitar>.Filter.Gt(g => g.EstablishedYear, 1985);
+
+// Finds all documents that match the filter
 var result = _guitarsCollection.Find(filter).ToList();
 
 foreach (var doc in result)
 {
+    // Prints the documents in bson (json) format
     Console.WriteLine(doc.ToBsonDocument());
 }

source/includes/fundamentals/code-examples/specify-query/FindRegexBuilder.cs

@@ -1,7 +1,11 @@
+// Creates a filter for all documents with a populated "ratings" field
 var filter = Builders<Guitar>.Filter.Regex(g => g.Make, "^G");
+
+// Finds all documents that match the filter
 var result = _guitarsCollection.Find(filter).ToList();
 
 foreach (var doc in result)
 {
+    // Prints the documents in bson (json) format
     Console.WriteLine(doc.ToBsonDocument());
 }

source/includes/fundamentals/code-examples/specify-query/FindSizeBuilder.cs

@@ -1,7 +1,11 @@
+// Creates a filter for all documents with 3 elements in the "models" field
 var filter = Builders<Guitar>.Filter.Size(g => g.Models, 3);
+
+// Finds all documents that match the filter
 var result = _guitarsCollection.Find(filter).ToList();
 
 foreach (var doc in result)
 {
+    // Prints the documents in bson (json) format
     Console.WriteLine(doc.ToBsonDocument());
 }