Skip to content

Commit 43c76b7

Browse files
committed
DOCSP-50751: agg tutorial link (#235)
* DOCSP-50751: agg tutorial link * wip * MW PR fixes 1 (cherry picked from commit 4cacec3)
1 parent 4223edf commit 43c76b7

File tree

1 file changed

+27
-11
lines changed

1 file changed

+27
-11
lines changed

source/fundamentals/aggregation.txt

Lines changed: 27 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -13,18 +13,33 @@ Aggregation
1313
Overview
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

2944
Aggregation 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

Comments
 (0)