CSHARP-2619: Documentation for countDocuments MUST mention estimatedDocumentCount

Author: vincentkam

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

@@ -27,6 +27,7 @@ namespace MongoDB.Driver.Core.Operations
 {
     /// <summary>
     /// Represents a count documents operation.
+    /// For a fast estimate of the total documents in a collection see <see cref="CountOperation"/>.
     /// </summary>
     public class CountDocumentsOperation : IReadOperation<long>
     {

src/MongoDB.Driver/IMongoCollection.cs

@@ -198,6 +198,7 @@ public interface IMongoCollection<TDocument>
 
         /// <summary>
         /// Counts the number of documents in the collection.
+        /// For a fast estimate of the total documents in a collection see <see cref="EstimatedDocumentCount"/>.
         /// </summary>
         /// <remarks>
         /// Note: when migrating from Count to CountDocuments the following query operations must be replaced:
@@ -224,6 +225,7 @@ public interface IMongoCollection<TDocument>
 
         /// <summary>
         /// Counts the number of documents in the collection.
+        /// For a fast estimate of the total documents in a collection see <see cref="EstimatedDocumentCount"/>.
         /// </summary>
         /// <remarks>
         /// Note: when migrating from Count to CountDocuments the following query operations must be replaced:
@@ -251,6 +253,7 @@ public interface IMongoCollection<TDocument>
 
         /// <summary>
         /// Counts the number of documents in the collection.
+        /// For a fast estimate of the total documents in a collection see <seea cref="EstimatedDocumentCountAsync"/>.
         /// </summary>
         /// <remarks>
         /// Note: when migrating from CountAsync to CountDocumentsAsync the following query operations must be replaced:
@@ -277,6 +280,7 @@ public interface IMongoCollection<TDocument>
 
         /// <summary>
         /// Counts the number of documents in the collection.
+        /// For a fast estimate of the total documents in a collection see <see cref="EstimatedDocumentCountAsync"/>.
         /// </summary>
         /// <remarks>
         /// Note: when migrating from CountAsync to CountDocumentsAsync the following query operations must be replaced:

src/MongoDB.Driver/IMongoCollectionExtensions.cs

@@ -163,6 +163,7 @@ public static IMongoQueryable<TDocument> AsQueryable<TDocument>(this IMongoColle
 
         /// <summary>
         /// Counts the number of documents in the collection.
+        /// For a fast estimate of the total documents in a collection see <see cref="IMongoCollection{TDocument}.EstimatedDocumentCount"/>.
         /// </summary>
         /// <typeparam name="TDocument">The type of the document.</typeparam>
         /// <param name="collection">The collection.</param>
@@ -182,6 +183,7 @@ public static IMongoQueryable<TDocument> AsQueryable<TDocument>(this IMongoColle
 
         /// <summary>
         /// Counts the number of documents in the collection.
+        /// For a fast estimate of the total documents in a collection see <see cref="IMongoCollection{TDocument}.EstimatedDocumentCount"/>.
         /// </summary>
         /// <typeparam name="TDocument">The type of the document.</typeparam>
         /// <param name="session">The session.</param>
@@ -203,6 +205,7 @@ public static IMongoQueryable<TDocument> AsQueryable<TDocument>(this IMongoColle
 
         /// <summary>
         /// Counts the number of documents in the collection.
+        /// For a fast estimate of the total documents in a collection see <see cref="IMongoCollection{TDocument}.EstimatedDocumentCountAsync"/>.
         /// </summary>
         /// <typeparam name="TDocument">The type of the document.</typeparam>
         /// <param name="collection">The collection.</param>
@@ -222,6 +225,7 @@ public static IMongoQueryable<TDocument> AsQueryable<TDocument>(this IMongoColle
 
         /// <summary>
         /// Counts the number of documents in the collection.
+        /// For a fast estimate of the total documents in a collection see <see cref="IMongoCollection{TDocument}.EstimatedDocumentCountAsync"/>.
         /// </summary>
         /// <typeparam name="TDocument">The type of the document.</typeparam>
         /// <param name="collection">The collection.</param>