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