Skip to content

Commit 4cacec3

Browse files
authored
DOCSP-50751: agg tutorial link (#235)
* DOCSP-50751: agg tutorial link * wip * MW PR fixes 1
1 parent 8c8b114 commit 4cacec3

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
@@ -16,18 +16,33 @@ Aggregation
1616
Overview
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

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

Comments
 (0)