@@ -16,18 +16,33 @@ Aggregation
1616Overview
1717--------
1818
19- In this guide, you can learn how to use **aggregation operations** in the MongoDB Kotlin driver.
19+ In this guide, you can learn how to use **aggregation operations** in
20+ the {+driver-short+}.
2021
21- Aggregation operations process data in your MongoDB collections and return computed results. MongoDB's Aggregation
22- pipeline, part of the Query API, is modeled on the concept of data processing pipelines. Documents enter a multi-staged pipeline that
23- transforms the documents into an aggregated result.
22+ Aggregation operations process data in your MongoDB collections and
23+ return computed results. MongoDB's aggregation pipeline, which is part of the
24+ Query API, is modeled on the concept of data-processing pipelines.
25+ Documents enter a multi-stage pipeline that transforms the documents
26+ into an aggregated result.
2427
25- Another way to think of aggregation is like a car factory. Within the car factory is an assembly line, along which
26- are assembly stations with specialized tools to do a specific job, like drills and welders. Raw parts enter the factory,
27- which are then transformed and assembled into a finished product.
28+ .. sharedinclude:: dbx/agg-tutorials-manual-tip.rst
2829
29- The **aggregation pipeline** is the assembly line, **aggregation stages** are the assembly stations, and
30- **operator expressions** are the specialized tools.
30+ .. replacement:: language
31+
32+ :guilabel:`{+language+} (Coroutine)`
33+
34+ Analogy
35+ ~~~~~~~
36+
37+ The functionality of an aggregation is similar to what occurs in a car
38+ factory. Within the car factory is an assembly line, along which are
39+ assembly stations with specialized tools to do a specific job, like
40+ drills and welders. Raw parts enter the factory, and the factory
41+ transforms them and assembles them into a finished product.
42+
43+ The **aggregation pipeline** is the assembly line, **aggregation
44+ stages** are the assembly stations, and **operator expressions** are the
45+ specialized tools.
3146
3247Aggregation and Find Operations Compared
3348~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -113,9 +128,10 @@ In the following example, the aggregation pipeline:
113128- Uses a :manual:`$group </reference/operator/aggregation/group/>` stage to group the matching documents by the ``stars``
114129 field, accumulating a count of documents for each distinct value of ``stars``.
115130
116- .. seealso ::
131+ .. tip ::
117132
118- You can build the expressions used in this example using the :ref:`aggregation builders <aggregates-builders>`.
133+ You can build the expressions used in this example by using the
134+ :ref:`aggregation builders <aggregates-builders>`.
119135
120136.. io-code-block::
121137
0 commit comments