Add comment for all examples converted to verbose form

Author: GromNaN

generator/config/accumulator/covariancePop.yaml

@@ -30,6 +30,7 @@ tests:
                         covariancePopForState:
                             $covariancePop:
                                 -
+                                    # Example uses the short form, the builder always generates the verbose form
                                     # $year: '$orderDate'
                                     $year:
                                         date: '$orderDate'

generator/config/accumulator/covarianceSamp.yaml

@@ -30,6 +30,7 @@ tests:
                         covarianceSampForState:
                             $covarianceSamp:
                                 -
+                                    # Example uses the short form, the builder always generates the verbose form
                                     # $year: '$orderDate'
                                     $year:
                                         date: '$orderDate'

generator/config/accumulator/push.yaml

@@ -26,10 +26,12 @@ tests:
                 $group:
                     _id:
                         day:
+                            # Example uses the short form, the builder always generates the verbose form
                             # $dayOfYear: '$date'
                             $dayOfYear:
                                 date: '$date'
                         year:
+                            # Example uses the short form, the builder always generates the verbose form
                             # $year: '$date'
                             $year:
                                 date: '$date'

generator/config/accumulator/sum.yaml

@@ -22,10 +22,12 @@ tests:
                 $group:
                     _id:
                         day:
+                            # Example uses the short form, the builder always generates the verbose form
                             # $dayOfYear: '$date'
                             $dayOfYear:
                                 date: '$date'
                         year:
+                            # Example uses the short form, the builder always generates the verbose form
                             # $year: '$date'
                             $year:
                                 date: '$date'

generator/config/expression/arrayToObject.yaml

@@ -20,7 +20,7 @@ tests:
                 $project:
                     item: 1
                     dimensions:
-                        # The example renders a single value, but the builder generates an array for consistency
+                        # Example uses the short form, the builder always generates the verbose form
                         # $arrayToObject: '$dimensions'
                         $arrayToObject:
                             - '$dimensions'

generator/config/expression/avg.yaml

@@ -21,6 +21,7 @@ tests:
             -
                 $project:
                     quizAvg:
+                        # Example uses the short form, the builder always generates the verbose form
                         # $avg: '$quizzes'
                         $avg:
                             - '$quizzes'

generator/config/expression/dateAdd.yaml

@@ -46,6 +46,7 @@ tests:
                             unit: 'day'
                             amount: 3
             -
+                # Example uses the short form, the builder always generates the verbose form
                 # $merge: 'shipping'
                 $merge:
                     into: 'shipping'

generator/config/expression/dateFromString.yaml

@@ -76,6 +76,5 @@ tests:
                         $dateFromString:
                             dateString: '$date'
                             timezone: '$timezone'
-                            # onNull: new Date(0)
                             onNull: !bson_utcdatetime 0
 

generator/config/expression/dateSubtract.yaml

@@ -43,6 +43,7 @@ tests:
                     $expr:
                         $eq:
                             -
+                                # Example uses the short form, the builder always generates the verbose form
                                 # $month: '$logout'
                                 $month:
                                     date: '$logout'
@@ -55,6 +56,7 @@ tests:
                             unit: 'hour'
                             amount: 3
             -
+                # Example uses the short form, the builder always generates the verbose form
                 # $merge: 'connectionTime'
                 $merge:
                     into: 'connectionTime'

generator/config/expression/dayOfMonth.yaml

@@ -30,6 +30,7 @@ tests:
             -
                 $project:
                     day:
+                        # Example uses the short form, the builder always generates the verbose form
                         # $dayOfMonth: '$date'
                         $dayOfMonth:
                             date: '$date'

generator/config/expression/dayOfWeek.yaml

@@ -30,6 +30,7 @@ tests:
             -
                 $project:
                     dayOfWeek:
+                        # Example uses the short form, the builder always generates the verbose form
                         # $dayOfWeek: '$date'
                         $dayOfWeek:
                             date: '$date'

generator/config/expression/dayOfYear.yaml

@@ -30,6 +30,7 @@ tests:
             -
                 $project:
                     dayOfYear:
+                        # Example uses the short form, the builder always generates the verbose form
                         # $dayOfYear: '$date'
                         $dayOfYear:
                             date: '$date'

generator/config/expression/getField.yaml

@@ -33,7 +33,7 @@ tests:
                     $expr:
                         $gt:
                             -
-                                # the builder uses the verbose form with parameter names
+                                # Example uses the short form, the builder always generates the verbose form
                                 # $getField: 'price.usd'
                                 $getField:
                                     field: 'price.usd'
@@ -48,7 +48,7 @@ tests:
                         $gt:
                             -
                                 $getField:
-                                    # the builder uses the verbose form with parameter names
+                                    # Example uses the short form, the builder always generates the verbose form
                                     # $literal: '$price'
                                     field:
                                         $literal: '$price'

generator/config/expression/hour.yaml

@@ -30,6 +30,7 @@ tests:
             -
                 $project:
                     hour:
+                        # Example uses the short form, the builder always generates the verbose form
                         # $hour: '$date'
                         $hour:
                             date: '$date'

generator/config/expression/isArray.yaml

@@ -22,8 +22,7 @@ tests:
                         $cond:
                             if:
                                 $and:
-                                    # The example in the docs uses the short syntax for $isArray,
-                                    # but the aggregation builder always uses the more verbose syntax.
+                                    # Example uses the short form, the builder always generates the verbose form
                                     -
                                         $isArray:
                                             - '$instock'

generator/config/expression/isoDayOfWeek.yaml

@@ -32,6 +32,7 @@ tests:
                     _id: 0
                     name: '$name'
                     dayOfWeek:
+                        # Example uses the short form, the builder always generates the verbose form
                         # $isoDayOfWeek: '$birthday'
                         $isoDayOfWeek:
                             date: '$birthday'

generator/config/expression/isoWeek.yaml

@@ -32,6 +32,7 @@ tests:
                     _id: 0
                     city: '$city'
                     weekNumber:
+                        # Example uses the short form, the builder always generates the verbose form
                         # $isoWeek: '$date'
                         $isoWeek:
                             date: '$date'

generator/config/expression/isoWeekYear.yaml

@@ -30,6 +30,7 @@ tests:
             -
                 $project:
                     yearNumber:
+                        # Example uses the short form, the builder always generates the verbose form
                         # $isoWeekYear: '$date'
                         $isoWeekYear:
                             date: '$date'

generator/config/expression/map.yaml

@@ -53,7 +53,7 @@ tests:
                             input: '$distances'
                             as: 'decimalValue'
                             in:
-                                # The example renders a single value, but the builder generates an array for consistency
+                                # Example uses the short form, the builder always generates the verbose form
                                 # $trunc: '$$decimalValue'
                                 $trunc:
                                     - '$$decimalValue'

generator/config/expression/max.yaml

@@ -21,6 +21,7 @@ tests:
             -
                 $project:
                     quizMax:
+                        # Example uses the short form, the builder always generates the verbose form
                         # $max: '$quizzes'
                         $max:
                             - '$quizzes'

generator/config/expression/millisecond.yaml

@@ -30,6 +30,7 @@ tests:
             -
                 $project:
                     milliseconds:
+                        # Example uses the short form, the builder always generates the verbose form
                         # $millisecond: '$date'
                         $millisecond:
                             date: '$date'

generator/config/expression/min.yaml

@@ -21,6 +21,7 @@ tests:
             -
                 $project:
                     quizMin:
+                        # Example uses the short form, the builder always generates the verbose form
                         # $min: '$quizzes'
                         $min:
                             - '$quizzes'

generator/config/expression/minute.yaml

@@ -30,6 +30,7 @@ tests:
             -
                 $project:
                     minutes:
+                        # Example uses the short form, the builder always generates the verbose form
                         # $minute: '$date'
                         $minute:
                             date: '$date'

generator/config/expression/month.yaml

@@ -30,6 +30,7 @@ tests:
             -
                 $project:
                     month:
+                        # Example uses the short form, the builder always generates the verbose form
                         # $month: '$date'
                         $month:
                             date: '$date'

generator/config/expression/objectToArray.yaml

@@ -33,7 +33,7 @@ tests:
                     warehouses:
                         $objectToArray: '$instock'
             -
-                # The builder uses the verbose form of the $unwind operator
+                # Example uses the short form, the builder always generates the verbose form
                 # $unwind: '$warehouses'
                 $unwind:
                     path: '$warehouses'

generator/config/expression/pow.yaml

@@ -25,7 +25,7 @@ tests:
                     variance:
                         $pow:
                             -
-                                # The builder renders $stdDevPop with the array form, even with a single value
+                                # Example uses the short form, the builder always generates the verbose form
                                 # $stdDevPop: '$scores.score'
                                 $stdDevPop: ['$scores.score']
                             - 2

generator/config/expression/rand.yaml

@@ -23,6 +23,7 @@ tests:
                     amount:
                         $floor: '$amount'
             -
+                # Example uses the short form, the builder always generates the verbose form
                 # $merge: 'donors'
                 $merge:
                     into: 'donors'

generator/config/expression/second.yaml

@@ -30,6 +30,7 @@ tests:
             -
                 $project:
                     seconds:
+                        # Example uses the short form, the builder always generates the verbose form
                         # $second: '$date'
                         $second:
                             date: '$date'

generator/config/expression/setField.yaml

@@ -39,6 +39,7 @@ tests:
                         input: '$$ROOT'
                         value: '$price'
             -
+                # Example uses the short form, the builder always generates the verbose form
                 # $unset: 'price'
                 $unset:
                     - 'price'
@@ -54,6 +55,7 @@ tests:
                         input: '$$ROOT'
                         value: '$price'
             -
+                # Example uses the short form, the builder always generates the verbose form
                 # $unset: 'price'
                 $unset:
                     - 'price'

generator/config/expression/size.yaml

@@ -24,8 +24,7 @@ tests:
                     numberOfColors:
                         $cond:
                             if:
-                                # The example in the docs uses the short syntax for $isArray,
-                                # but the aggregation builder always uses the more verbose syntax.
+                                # Example uses the short form, the builder always generates the verbose form
                                 # $isArray: '$colors'
                                 $isArray:
                                     - '$colors'

generator/config/expression/sortArray.yaml

@@ -101,8 +101,7 @@ tests:
                                     a:
                                         sale: true
                                         price: 19
-                                # Decimal128( "10.23" )
-                                - 10.23
+                                - !bson_decimal128 '10.23'
                                 -
                                     a: 'On sale'
                             sortBy: 1

generator/config/expression/stdDevPop.yaml

@@ -22,5 +22,6 @@ tests:
             -
                 $project:
                     stdDev:
+                        # Example uses the short form, the builder always generates the verbose form
                         # $stdDevPop: '$scores.score'
                         $stdDevPop: ['$scores.score']

generator/config/expression/sum.yaml

@@ -22,6 +22,7 @@ tests:
             -
                 $project:
                     quizTotal:
+                        # Example uses the short form, the builder always generates the verbose form
                         # $sum: '$quizzes'
                         $sum:
                             - '$quizzes'

generator/config/expression/unsetField.yaml

@@ -53,6 +53,7 @@ tests:
                             $unsetField:
                                 field: 'euro'
                                 input:
+                                    # Example uses the short form, the builder always generates the verbose form
                                     # $getField: 'price'
                                     $getField:
                                         field: 'price'

generator/config/expression/week.yaml

@@ -30,6 +30,7 @@ tests:
             -
                 $project:
                     week:
+                        # Example uses the short form, the builder always generates the verbose form
                         # $week: '$date'
                         $week:
                             date: '$date'

generator/config/expression/year.yaml

@@ -30,6 +30,7 @@ tests:
             -
                 $project:
                     year:
+                        # Example uses the short form, the builder always generates the verbose form
                         # $year: '$date'
                         $year:
                             date: '$date'

generator/config/query/type.yaml

@@ -21,31 +21,31 @@ tests:
             -
                 $match:
                     zipCode:
-                        # Example uses the short form, the builder always generated the verbose form
+                        # Example uses the short form, the builder always generates the verbose form
                         # $type: 2
                         $type: [2]
             -
                 $match:
                     zipCode:
-                        # Example uses the short form, the builder always generated the verbose form
+                        # Example uses the short form, the builder always generates the verbose form
                         # $type: 'string'
                         $type: ['string']
             -
                 $match:
                     zipCode:
-                        # Example uses the short form, the builder always generated the verbose form
+                        # Example uses the short form, the builder always generates the verbose form
                         # $type: 1
                         $type: [1]
             -
                 $match:
                     zipCode:
-                        # Example uses the short form, the builder always generated the verbose form
+                        # Example uses the short form, the builder always generates the verbose form
                         # $type: 'double'
                         $type: ['double']
             -
                 $match:
                     zipCode:
-                        # Example uses the short form, the builder always generated the verbose form
+                        # Example uses the short form, the builder always generates the verbose form
                         # $type: 'number'
                         $type: ['number']
     -
@@ -67,13 +67,13 @@ tests:
             -
                 $match:
                     zipCode:
-                        # Example uses the short form, the builder always generated the verbose form
+                        # Example uses the short form, the builder always generates the verbose form
                         # $type: 'minKey'
                         $type: ['minKey']
             -
                 $match:
                     zipCode:
-                        # Example uses the short form, the builder always generated the verbose form
+                        # Example uses the short form, the builder always generates the verbose form
                         # $type: 'maxKey'
                         $type: ['maxKey']
     -
@@ -83,6 +83,6 @@ tests:
             -
                 $match:
                     zipCode:
-                        # Example uses the short form, the builder always generated the verbose form
+                        # Example uses the short form, the builder always generates the verbose form
                         # $type: 'array'
                         $type: ['array']