Fix Sandcastle API docs warnings.

Author: rstam

src/MongoDB.Driver.Core/Core/Operations/MapReduceOperationBase.cs

@@ -210,6 +210,7 @@ public bool? Verbose
         /// <summary>
         /// Creates the command.
         /// </summary>
+        /// <param name="serverVersion">The server version.</param>
         /// <returns>The command.</returns>
         protected internal virtual BsonDocument CreateCommand(SemanticVersion serverVersion)
         {

src/MongoDB.Driver.Core/IAsyncCursorSource.cs

@@ -66,6 +66,7 @@ public static class IAsyncCursorSourceExtensions
         /// <summary>
         /// Determines whether the cursor returned by a cursor source contains any documents.
         /// </summary>
+        /// <typeparam name="TDocument">The type of the document.</typeparam>
         /// <param name="source">The source.</param>
         /// <param name="cancellationToken">The cancellation token.</param>
         /// <returns>A Task whose result is true if the cursor contains any documents.</returns>

src/MongoDB.Driver.Legacy/Builders/CollectionOptionsBuilder.cs

@@ -59,8 +59,8 @@ public static CollectionOptionsBuilder SetCapped(bool value)
         /// <summary>
         /// Sets the index options defaults.
         /// </summary>
+        /// <param name="value">The value.</param>
         /// <returns>The builder (so method calls can be chained).</returns>
-        /// <returns></returns>
         public static CollectionOptionsBuilder SetIndexOptionDefaults(IndexOptionDefaults value)
         {
             return new CollectionOptionsBuilder().SetIndexOptionDefaults(value);

src/MongoDB.Driver/AggregateFluent.cs

@@ -86,15 +86,15 @@ public override IAggregateFluent<TResult> Limit(int limit)
             return AppendStage<TResult>(new BsonDocument("$limit", limit));
         }
 
-        public override IAggregateFluent<TNewResult> Lookup<TForeignCollection, TNewResult>(string foreignCollectionName, FieldDefinition<TResult> localField, FieldDefinition<TForeignCollection> foreignField, FieldDefinition<TNewResult> @as, AggregateLookupOptions<TForeignCollection, TNewResult> options)
+        public override IAggregateFluent<TNewResult> Lookup<TForeignDocument, TNewResult>(string foreignCollectionName, FieldDefinition<TResult> localField, FieldDefinition<TForeignDocument> foreignField, FieldDefinition<TNewResult> @as, AggregateLookupOptions<TForeignDocument, TNewResult> options)
         {
-            options = options ?? new AggregateLookupOptions<TForeignCollection, TNewResult>();
+            options = options ?? new AggregateLookupOptions<TForeignDocument, TNewResult>();
             const string operatorName = "$lookup";
             var stage = new DelegatedPipelineStageDefinition<TResult, TNewResult>(
                 operatorName,
                 (localSerializer, sr) =>
                 {
-                    var foreignSerializer = options.ForeignSerializer ?? (localSerializer as IBsonSerializer<TForeignCollection>) ?? sr.GetSerializer<TForeignCollection>();
+                    var foreignSerializer = options.ForeignSerializer ?? (localSerializer as IBsonSerializer<TForeignDocument>) ?? sr.GetSerializer<TForeignDocument>();
                     var newResultSerializer = options.ResultSerializer ?? (localSerializer as IBsonSerializer<TNewResult>) ?? sr.GetSerializer<TNewResult>();
                     return new RenderedPipelineStageDefinition<TNewResult>(
                         operatorName, new BsonDocument(operatorName, new BsonDocument

src/MongoDB.Driver/AggregateFluentBase.cs

@@ -47,7 +47,7 @@ public abstract class AggregateFluentBase<TResult> : IOrderedAggregateFluent<TRe
         public abstract IAggregateFluent<TResult> Limit(int limit);
 
         /// <inheritdoc />
-        public virtual IAggregateFluent<TNewResult> Lookup<TForeignCollection, TNewResult>(string otherCollectionName, FieldDefinition<TResult> localField, FieldDefinition<TForeignCollection> foreignField, FieldDefinition<TNewResult> @as, AggregateLookupOptions<TForeignCollection, TNewResult> options)
+        public virtual IAggregateFluent<TNewResult> Lookup<TForeignDocument, TNewResult>(string foreignCollectionName, FieldDefinition<TResult> localField, FieldDefinition<TForeignDocument> foreignField, FieldDefinition<TNewResult> @as, AggregateLookupOptions<TForeignDocument, TNewResult> options)
         {
             throw new NotImplementedException();
         }

src/MongoDB.Driver/AggregateUnwindOptions.cs

@@ -20,6 +20,7 @@ namespace MongoDB.Driver
     /// <summary>
     /// Options for the $unwind aggregation stage.
     /// </summary>
+    /// <typeparam name="TResult">The type of the result.</typeparam>
     public class AggregateUnwindOptions<TResult>
     {
         private FieldDefinition<TResult> _includeArrayIndex;

src/MongoDB.Driver/IAggregateFluent.cs

@@ -159,7 +159,7 @@ public interface IAggregateFluent<TResult> : IAsyncCursorSource<TResult>
         /// <typeparam name="TNewResult">The type of the new result.</typeparam>
         /// <param name="field">The field.</param>
         /// <param name="options">The options.</param>
-        /// The fluent aggregate interface.
+        /// <returns>The fluent aggregate interface.</returns>
         IAggregateFluent<TNewResult> Unwind<TNewResult>(FieldDefinition<TResult> field, AggregateUnwindOptions<TNewResult> options = null);
     }
 

src/MongoDB.Driver/IAggregateFluentExtensions.cs

@@ -103,7 +103,7 @@ public static IAggregateFluent<BsonDocument> Lookup<TResult>(this IAggregateFlue
         /// Appends a lookup stage to the pipeline.
         /// </summary>
         /// <typeparam name="TResult">The type of the result.</typeparam>
-        /// <typeparam name="TForeignCollection">The type of the foreign collection.</typeparam>
+        /// <typeparam name="TForeignDocument">The type of the foreign collection.</typeparam>
         /// <typeparam name="TNewResult">The type of the new result.</typeparam>
         /// <param name="aggregate">The aggregate.</param>
         /// <param name="foreignCollection">The foreign collection.</param>
@@ -112,20 +112,20 @@ public static IAggregateFluent<BsonDocument> Lookup<TResult>(this IAggregateFlue
         /// <param name="as">The field in the result to place the foreign matches.</param>
         /// <param name="options">The options.</param>
         /// <returns>The fluent aggregate interface.</returns>
-        public static IAggregateFluent<TNewResult> Lookup<TResult, TForeignCollection, TNewResult>(this IAggregateFluent<TResult> aggregate,
-            IMongoCollection<TForeignCollection> foreignCollection,
+        public static IAggregateFluent<TNewResult> Lookup<TResult, TForeignDocument, TNewResult>(this IAggregateFluent<TResult> aggregate,
+            IMongoCollection<TForeignDocument> foreignCollection,
             Expression<Func<TResult, object>> localField,
-            Expression<Func<TForeignCollection, object>> foreignField,
+            Expression<Func<TForeignDocument, object>> foreignField,
             Expression<Func<TNewResult, object>> @as,
-            AggregateLookupOptions<TForeignCollection, TNewResult> options = null)
+            AggregateLookupOptions<TForeignDocument, TNewResult> options = null)
         {
             Ensure.IsNotNull(aggregate, nameof(aggregate));
             Ensure.IsNotNull(foreignCollection, nameof(foreignCollection));
             Ensure.IsNotNull(localField, nameof(localField));
             Ensure.IsNotNull(foreignField, nameof(foreignField));
             Ensure.IsNotNull(@as, nameof(@as));
 
-            options = options ?? new AggregateLookupOptions<TForeignCollection, TNewResult>();
+            options = options ?? new AggregateLookupOptions<TForeignDocument, TNewResult>();
             if (options.ForeignSerializer == null)
             {
                 options.ForeignSerializer = foreignCollection.DocumentSerializer;
@@ -134,7 +134,7 @@ public static IAggregateFluent<TNewResult> Lookup<TResult, TForeignCollection, T
             return aggregate.Lookup(
                 foreignCollection.CollectionNamespace.CollectionName,
                 new ExpressionFieldDefinition<TResult>(localField),
-                new ExpressionFieldDefinition<TForeignCollection>(foreignField),
+                new ExpressionFieldDefinition<TForeignDocument>(foreignField),
                 new ExpressionFieldDefinition<TNewResult>(@as),
                 options);
         }