Skip to content

Commit 49b9dea

Browse files
committed
DOCSP-50754: Add agg tutorials links (#277)
* DOCSP-50754: Add agg tutorials links * redirects * build error (cherry picked from commit ca76a2a) (cherry picked from commit c41a005) (cherry picked from commit baf8bcc) (cherry picked from commit 95a673f)
1 parent 6388561 commit 49b9dea

File tree

9 files changed

+19
-1152
lines changed

9 files changed

+19
-1152
lines changed

config/redirects

Lines changed: 12 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,7 @@
11
define: prefix docs/languages/python/pymongo-driver
22
define: base https://www.mongodb.com/${prefix}
33
define: versions v4.0 v4.1 v4.2 v4.3 v4.4 v4.5 v4.6 v4.7 v4.8 v4.9 master
4+
define: server https://www.mongodb.com/docs/manual
45

56
symlink: current -> master
67

@@ -70,10 +71,16 @@ raw: ${prefix}/get-started/download-and-install/ -> ${base}/current/get-started/
7071
[*-master]: ${prefix}/${version}/indexes/wildcard-index/ -> ${base}/${version}/indexes/
7172
[*-master]: ${prefix}/${version}/indexes/clustered-index/ -> ${base}/${version}/indexes/
7273

74+
# Aggregation tutorials redirects
7375
[*-master]: ${prefix}/${version}/aggregation/aggregation-tutorials/ -> ${base}/${version}/aggregation/
74-
[*-master]: ${prefix}/${version}/aggregation/aggregation-tutorials/filtered-subset/ -> ${base}/${version}/aggregation/filtered-subset/
75-
[*-master]: ${prefix}/${version}/aggregation/aggregation-tutorials/group-total/ -> ${base}/${version}/aggregation/group-total/
76-
[*-master]: ${prefix}/${version}/aggregation/aggregation-tutorials/multi-field-join/ -> ${base}/${version}/aggregation/multi-field-join/
77-
[*-master]: ${prefix}/${version}/aggregation/aggregation-tutorials/one-to-one-join/ -> ${base}/${version}/aggregation/one-to-one-join/
78-
[*-master]: ${prefix}/${version}/aggregation/aggregation-tutorials/unpack-arrays/ -> ${base}/${version}/aggregation/unpack-arrays/
76+
[*-master]: ${prefix}/${version}/aggregation/aggregation-tutorials/filtered-subset/ -> ${server}/tutorial/aggregation-examples/filtered-subset/
77+
[*-master]: ${prefix}/${version}/aggregation/filtered-subset/ -> ${server}/tutorial/aggregation-examples/filtered-subset/
78+
[*-master]: ${prefix}/${version}/aggregation/aggregation-tutorials/group-total/ -> ${server}/tutorial/aggregation-examples/group-and-total/
79+
[*-master]: ${prefix}/${version}/aggregation/group-total/ -> ${server}/tutorial/aggregation-examples/group-and-total/
80+
[*-master]: ${prefix}/${version}/aggregation/aggregation-tutorials/multi-field-join/ -> ${server}/tutorial/aggregation-examples/multi-field-join/
81+
[*-master]: ${prefix}/${version}/aggregation/multi-field-join/ -> ${server}/tutorial/aggregation-examples/multi-field-join/
82+
[*-master]: ${prefix}/${version}/aggregation/aggregation-tutorials/one-to-one-join/ ->${server}/tutorial/aggregation-examples/one-to-one-join/
83+
[*-master]: ${prefix}/${version}/aggregation/one-to-one-join/ -> ${server}/tutorial/aggregation-examples/one-to-one-join/
84+
[*-master]: ${prefix}/${version}/aggregation/aggregation-tutorials/unpack-arrays/ -> ${server}/tutorial/aggregation-examples/unpack-arrays/
85+
[*-master]: ${prefix}/${version}/aggregation/unpack-arrays/ -> ${server}/tutorial/aggregation-examples/unpack-arrays/
7986

snooty.toml

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,6 @@ title = "PyMongo Driver"
33
toc_landing_pages = [
44
"/get-started",
55
"/connect",
6-
"/aggregation",
76
"/security",
87
"/security/authentication",
98
"/data-formats",

source/aggregation.txt

Lines changed: 6 additions & 45 deletions
Original file line numberDiff line numberDiff line change
@@ -18,16 +18,6 @@ Transform Your Data with Aggregation
1818
:depth: 2
1919
:class: singlecol
2020

21-
.. toctree::
22-
:titlesonly:
23-
:maxdepth: 1
24-
25-
Filtered Subset </aggregation/filtered-subset/>
26-
Group & Total </aggregation/group-total/>
27-
Unpack Arrays & Group </aggregation/unpack-arrays/>
28-
One-to-One Join </aggregation/one-to-one-join/>
29-
Multi-Field Join </aggregation/multi-field-join/>
30-
3121
Overview
3222
--------
3323

@@ -50,6 +40,12 @@ The **aggregation pipeline** is the assembly line, **aggregation stages** are th
5040
assembly stations, and **operator expressions** are the
5141
specialized tools.
5242

43+
.. sharedinclude:: dbx/agg-tutorials-manual-tip.rst
44+
45+
.. replacement:: language
46+
47+
:guilabel:`{+language+}`
48+
5349
Aggregation Versus Find Operations
5450
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
5551

@@ -254,41 +250,6 @@ To learn more about explaining MongoDB operations, see
254250
:manual:`Explain Output </reference/explain-results/>` and
255251
:manual:`Query Plans. </core/query-plans/>`
256252

257-
Aggregation Tutorials
258-
~~~~~~~~~~~~~~~~~~~~~
259-
260-
To view step-by-step explanations of common aggregation tasks, see
261-
the following tutorials:
262-
263-
- :ref:`pymongo-aggregation-filtered-subset`
264-
- :ref:`pymongo-aggregation-group-total`
265-
- :ref:`pymongo-aggregation-arrays`
266-
- :ref:`pymongo-aggregation-one-to-one`
267-
- :ref:`pymongo-aggregation-multi-field`
268-
269-
Aggregation tutorials provide detailed explanations of common
270-
aggregation tasks in a step-by-step format. The tutorials are adapted
271-
from examples in the `Practical MongoDB Aggregations book
272-
<https://www.practical-mongodb-aggregations.com/>`__ by Paul Done.
273-
274-
Each tutorial includes the following sections:
275-
276-
- **Introduction**, which describes the purpose and common use cases of the
277-
aggregation type. This section also describes the example and desired
278-
outcome that the tutorial demonstrates.
279-
280-
- **Before You Get Started**, which describes the necessary databases,
281-
collections, and sample data that you must have before building the
282-
aggregation pipeline and performing the aggregation.
283-
284-
- **Tutorial**, which describes how to build and run the aggregation
285-
pipeline. This section describes each stage of the completed
286-
aggregation tutorial, and then explains how to run and interpret the
287-
output of the aggregation.
288-
289-
At the end of each aggregation tutorial, you can find a link to a fully
290-
runnable Python code file that you can run in your environment.
291-
292253
API Documentation
293254
~~~~~~~~~~~~~~~~~
294255

source/aggregation/filtered-subset.txt

Lines changed: 0 additions & 186 deletions
This file was deleted.

0 commit comments

Comments
 (0)