CR Changes

Author: craiggwilson

Docs/reference/content/reference/driver/crud/reading.md

@@ -106,7 +106,7 @@ var result = await collection.Find(filter)
 
 ## Aggregation
 
-MongoDB offers the [aggregation framework]({{< docsref "core/aggregation-pipeline/" >}}) which can be accessed via the [`Aggregate`]({{< apiref "M_MongoDB_Driver_IMongoCollectionExtensions_Aggregate__1" >}}) method. The result type is [`IAggregateFluent`]({{< apiref "T_MongoDB_Driver_IAggregateFluent_1" >}}) and provides access to build up and aggregation pipeline.
+MongoDB offers the [aggregation framework]({{< docsref "core/aggregation-pipeline/" >}}) which can be accessed via the [`Aggregate`]({{< apiref "M_MongoDB_Driver_IMongoCollectionExtensions_Aggregate__1" >}}) method. The result type is [`IAggregateFluent`]({{< apiref "T_MongoDB_Driver_IAggregateFluent_1" >}}) and provides access to a fluent API to build up an aggregation pipeline.
 
 The first example from [MongoDB's documentation]({{< docsref "tutorial/aggregation-zip-code-data-set/#return-states-with-populations-above-10-million" >}}) is done in a type-safe manner below:
 
@@ -127,9 +127,10 @@ class ZipEntry
     public int Population { get; set; }
 }
 
-var pipeline = db.GetCollection<ZipEntry>.Aggregate()
+var results = await db.GetCollection<ZipEntry>.Aggregate()
 	.Group(x => x.State, g => new { State = g.Key, TotalPopulation = g.Sum(x => x.Population) })
-	.Match(x => x.TotalPopulation > 20000);
+	.Match(x => x.TotalPopulation > 20000)
+	.ToListAsync();
 ```
 
 This will result in the following aggregation pipeline getting sent to the server:
@@ -147,11 +148,11 @@ More samples are located in the [source]({{< srcref "MongoDB.Driver.Tests/Sample
 
 All the [stage operators]({{< docsref "reference/operator/aggregation/#aggregation-pipeline-operator-reference" >}}) are supported, however some of them must use the [`AppendStage`]({{< apiref "M_MongoDB_Driver_IAggregateFluent_1_AppendStage__1" >}}) method due to lack of support for certain projections in the language.
 
-{{% note class="important" %}}Unlike `Find`, the order that stages are defined in matters. `Skip(10).Limit(10)` is not the same as `Limit(10).Skip(10)`.{{% /note %}}
+{{% note class="important" %}}Unlike `Find`, the order that stages are defined in matters. `Skip(10).Limit(20)` is not the same as `Limit(20).Skip(10)`.{{% /note %}}
 
 #### $project
 
-A `$project` is rendered using the [`Project`]({{< apiref "M_MongoDB_Driver_IAggregateFluent_1_Project__1" >}}) method and its overloads. Unlike in `Find`, an aggregate projection is not executed client-side and must be fully translatable to the server's supported expressions.  See [expressions]({{< relref "reference\driver\expressions.md#projections" >}}) for more detail about the expressions available inside a $project.
+A `$project` is defined using the [`Project`]({{< apiref "M_MongoDB_Driver_IAggregateFluent_1_Project__1" >}}) method and its overloads. Unlike in `Find`, an aggregate projection is not executed client-side and must be fully translatable to the server's supported expressions.  See [expressions]({{< relref "reference\driver\expressions.md#projections" >}}) for more detail about the expressions available inside a $project.
 
 ```csharp
 Project(x => new { Name = x.FirstName + " " + x.LastName });
@@ -164,7 +165,7 @@ Project(x => new { Name = x.FirstName + " " + x.LastName });
 
 #### $match
 
-A `$match` stage is rendered using the [`Match`]({{< apiref "M_MongoDB_Driver_IAggregateFluent_1_Match" >}}) method and its overloads. It follows the same requirements as that of `Find`.
+A `$match` stage is defined using the [`Match`]({{< apiref "M_MongoDB_Driver_IAggregateFluent_1_Match" >}}) method and its overloads. It follows the same requirements as that of `Find`.
 
 ```csharp
 Match(x => x.Age > 21);
@@ -179,7 +180,7 @@ There is no method defined for a `$redact` stage. However, it can be added using
 
 #### $limit
 
-A `$limit` stage is rendered using the [`Limit`]({{< apiref "M_MongoDB_Driver_IAggregateFluent_1_Limit" >}}) method.
+A `$limit` stage is defined using the [`Limit`]({{< apiref "M_MongoDB_Driver_IAggregateFluent_1_Limit" >}}) method.
 
 ```csharp
 Limit(20);
@@ -190,7 +191,7 @@ Limit(20);
 
 #### $skip
 
-A `$skip` stage is rendered using the [`Skip`]({{< apiref "M_MongoDB_Driver_IAggregateFluent_1_Skip" >}}) method.
+A `$skip` stage is defined using the [`Skip`]({{< apiref "M_MongoDB_Driver_IAggregateFluent_1_Skip" >}}) method.
 
 ```csharp
 Skip(20);
@@ -201,7 +202,7 @@ Skip(20);
 
 #### $unwind
 
-An `$unwind` stage is rendered using the [`Unwind`]({{< apiref "M_MongoDB_Driver_IAggregateFluent_1_Unwind__1" >}}) method and its overloads. Because $unwind is a type of projection, you must provide a return type, although not specifying one will use the overload that projects into a [`BsonDocument`]({{< apiref "T_MongoDB_Bson_BsonDocument" >}}).
+An `$unwind` stage is defined using the [`Unwind`]({{< apiref "M_MongoDB_Driver_IAggregateFluent_1_Unwind__1" >}}) method and its overloads. Because $unwind is a type of projection, you must provide a return type, although not specifying one will use the overload that projects into a [`BsonDocument`]({{< apiref "T_MongoDB_Bson_BsonDocument" >}}).
 
 ```csharp
 Unwind(x => x.ArrayFieldToUnwind);
@@ -212,7 +213,7 @@ Unwind(x => x.ArrayFieldToUnwind);
 
 #### $group
 
-A `$group` stage is rendered using the [`Group`]({{< apiref "M_MongoDB_Driver_IAggregateFluent_1_Group__1" >}}) method and its overloads. Because $unwind is a type of projection, you must provide a return type. The most useful of the overloads is where 2 lambda expressions are expressed, the first for the key and the second for the grouping. See [expressions]({{< relref "reference\driver\expressions.md#grouping" >}}) for more detail about the expressions available inside a $group.
+A `$group` stage is defined using the [`Group`]({{< apiref "M_MongoDB_Driver_IAggregateFluent_1_Group__1" >}}) method and its overloads. Because $unwind is a type of projection, you must provide a return type. The most useful of the overloads is where two lambda expressions are expressed, the first for the key and the second for the grouping. See [expressions]({{< relref "reference\driver\expressions.md#grouping" >}}) for more detail about the expressions available inside a $group.
 
 ```csharp
 Group(x => x.Name, g => new { Name = g.Key, AverageAge = g.Average(x = x.Age) });
@@ -225,7 +226,7 @@ As in project, it is required that the result of the grouping be a new type, eit
 
 #### $sort
 
-A `$sort` stage is rendered using the [`Sort`]({{< apiref "M_MongoDB_Driver_IAggregateFluent_1_Sort" >}}) method. However, `SortBy`, `SortByDescending`, `ThenBy`, and `ThenByDescending` are also present. 
+A `$sort` stage is defined using the [`Sort`]({{< apiref "M_MongoDB_Driver_IAggregateFluent_1_Sort" >}}) method. However, `SortBy`, `SortByDescending`, `ThenBy`, and `ThenByDescending` are also available. 
 
 ```csharp
 SortBy(x => x.LastName).ThenByDescending(x => x.Age);
@@ -240,10 +241,10 @@ There is no method defined for a `$geoNear` stage. However, it can be added usin
 
 #### $out
 
-A `$out` stage is rendered using the [`Out`]({{< apiref "M_MongoDB_Driver_IAggregateFluent_1_Out" >}}) method.
+A `$out` stage is defined using the [`OutAsync`]({{< apiref "M_MongoDB_Driver_IAggregateFluent_1_OutAsync" >}}) method. It must be the final stage and it triggers execution of the operation.
 
 ```csharp
-Out("myNewCollection");
+OutAsync("myNewCollection");
 ```
 ```json
 { $out: 'myNewCollection' }

Docs/reference/content/reference/driver/crud/writing.md

@@ -104,7 +104,7 @@ var result = await collection.FindOneAndDeleteAsync(filter);
 
 if (result != null)
 {
-	Assert(result["FirstName"] == "Jack");
+    Assert(result["FirstName"] == "Jack");
 }
 ```
 
@@ -170,7 +170,7 @@ var result = await collection.FindOneAndUpdateAsync(filter, update, options);
 
 if (result != null)
 {
-	Assert(result["FirstName"] == "John");
+    Assert(result["FirstName"] == "John");
 }
 ```
 

Docs/reference/content/reference/driver/expressions.md

@@ -302,7 +302,7 @@ Find(x => x.FavoriteNumbers.Count() == 3);
 { FavoriteNumbers: { $size: 3 } }
 ```
 
-## Aggregate
+## Aggregation Projections
 
 We'll walk through the supported expressions below. The [tests]({{< srcref "MongoDB.Driver.Tests/Linq/Translators/AggregateProjectionTranslatorTests_Project.cs" >}}) are also a good reference.
 
@@ -799,11 +799,11 @@ p => p.Name ?? "awesome";
 
 See the [MongoDB documentation]({{< docsref "meta/aggregation-quick-reference/#accumulators" >}}) for more information on each operator.
 
-Also, the [tests]({{< srcref "MongoDB.Driver.Tests/Linq/Translators/AggregateProjectionTranslatorTests_Group.cs" >}}) are also a good reference.
+Also, the [tests]({{< srcref "MongoDB.Driver.Tests/Linq/Translators/AggregateProjectionTranslatorTests_Group.cs" >}}) are a good reference.
 
 {{% note %}}These are only supported in a grouping expression.{{% /note %}}
 
-In the below, it should be assumed that `g` is of type [`IGrouping<TKey, TElement>`]({{< msdnref "bb344977" >}}).
+In the examples below, it should be assumed that `g` is of type [`IGrouping<TKey, TElement>`]({{< msdnref "bb344977" >}}).
 
 #### $sum