Merge bd7ca47 into 3e147e8

dconeybe · web-flow · commit baea71e5a785 · 2024-01-09T21:30:44.000Z
diff --git a/Firestore/Source/Public/FirebaseFirestore/FIRAggregateSource.h b/Firestore/Source/Public/FirebaseFirestore/FIRAggregateSource.h
@@ -30,7 +30,7 @@ typedef NS_ENUM(NSUInteger, FIRAggregateSource) {
    * The result received from the server is presented, unaltered, without considering any local
    * state. That is, documents in the local cache are not taken into consideration, neither are
    * local modifications not yet synchronized with the server. Previously-downloaded results, if
-   * any, are not used: every request using this source necessarily involves a round trip to the
+   * any, are not used. Every request using this source necessarily involves a round trip to the
    * server.
    *
    * The `AggregateQuery` will fail if the server cannot be reached, such as if the client is
diff --git a/Firestore/Source/Public/FirebaseFirestore/FIRQuery.h b/Firestore/Source/Public/FirebaseFirestore/FIRQuery.h
@@ -559,9 +559,9 @@ NS_SWIFT_NAME(Query)
  * A query that counts the documents in the result set of this query, without actually downloading
  * the documents.
  *
- * Using this `AggregateQuery` to count the documents is efficient because only the final count,
- * not the documents' data, is downloaded. This allows for counting document collections that would
- * otherwise be too large to download (e.g. containing thousands of documents).
+ * Using this `AggregateQuery` to count the documents is efficient because only the final count, not
+ * the documents' data, is downloaded. The `AggregateQuery` can count the documents if the result
+ * set would be prohibitively large to download entirely (thousands of documents).
  */
 @property(nonatomic, readonly) FIRAggregateQuery *count;
 
@@ -570,8 +570,9 @@ NS_SWIFT_NAME(Query)
  * of this query, without actually downloading the documents.
  *
  * Using an `AggregateQuery` to perform aggregations is efficient because only the final aggregation
- * values, not the documents' data, is downloaded. This allows for aggregating document collections
- * that would otherwise be too large to download (e.g. containing thousands of documents).
+ * values, not the documents' data, is downloaded. The returned `AggregateQuery` can perform
+ * aggregations of the documents if the result set would be prohibitively large to download entirely
+ * (thousands of documents).
  *
  * @param aggregateFields Specifies the aggregate operations to perform on the result set of this
  * query.

Original file line number	Diff line number	Diff line change
`@@ -30,7 +30,7 @@ typedef NS_ENUM(NSUInteger, FIRAggregateSource) {`
`30`	`30`	`* The result received from the server is presented, unaltered, without considering any local`
`31`	`31`	`* state. That is, documents in the local cache are not taken into consideration, neither are`
`32`	`32`	`* local modifications not yet synchronized with the server. Previously-downloaded results, if`
`33`		`- * any, are not used: every request using this source necessarily involves a round trip to the`
	`33`	`+ * any, are not used. Every request using this source necessarily involves a round trip to the`
`34`	`34`	`* server.`
`35`	`35`	`*`
`36`	`36`	* The `AggregateQuery` will fail if the server cannot be reached, such as if the client is