From e2d58c56b6b5604dcbecb9d76e7c9fc85c324f8e Mon Sep 17 00:00:00 2001 From: rustagir Date: Tue, 17 Jun 2025 14:50:25 -0400 Subject: [PATCH 1/2] DOCSP-50747: agg tutorial link --- snooty.toml | 1 + source/aggregation.txt | 6 ++++++ 2 files changed, 7 insertions(+) diff --git a/snooty.toml b/snooty.toml index 6bc096d1..5094fa11 100644 --- a/snooty.toml +++ b/snooty.toml @@ -30,3 +30,4 @@ string-data-type = "``string``" int-data-type = "``int``" stable-api = "Stable API" mdb-server = "MongoDB Server" +language = "C++" diff --git a/source/aggregation.txt b/source/aggregation.txt index 4a76cf1b..9eddf542 100644 --- a/source/aggregation.txt +++ b/source/aggregation.txt @@ -47,6 +47,12 @@ The **aggregation pipeline** is the assembly line, **aggregation stages** are th assembly stations, and **operator expressions** are the specialized tools. +.. sharedinclude:: dbx/agg-tutorials-manual-tip.rst + + .. replacement:: language + + :guilabel:`{+language+}11` + Aggregation Versus Find Operations ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ From 0203af81a87808bbc00151992e7ded1a02d16668 Mon Sep 17 00:00:00 2001 From: rustagir Date: Tue, 17 Jun 2025 16:17:35 -0400 Subject: [PATCH 2/2] wip --- source/aggregation.txt | 19 +++++++++++-------- 1 file changed, 11 insertions(+), 8 deletions(-) diff --git a/source/aggregation.txt b/source/aggregation.txt index 9eddf542..19737cbf 100644 --- a/source/aggregation.txt +++ b/source/aggregation.txt @@ -37,22 +37,25 @@ part of the Query API, is modeled on the concept of data processing pipelines. Documents enter a pipeline that contains one or more stages, and this pipeline transforms the documents into an aggregated result. +.. sharedinclude:: dbx/agg-tutorials-manual-tip.rst + + .. replacement:: language + + :guilabel:`{+language+}11` + +Analogy +~~~~~~~ + An aggregation operation is similar to a car factory. A car factory has an assembly line, which contains assembly stations with specialized tools to do specific jobs, like drills and welders. Raw parts enter the factory, and then the assembly line transforms and assembles them into a finished product. -The **aggregation pipeline** is the assembly line, **aggregation stages** are the -assembly stations, and **operator expressions** are the +The **aggregation pipeline** is the assembly line, **aggregation +stages** are the assembly stations, and **operator expressions** are the specialized tools. -.. sharedinclude:: dbx/agg-tutorials-manual-tip.rst - - .. replacement:: language - - :guilabel:`{+language+}11` - Aggregation Versus Find Operations ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~