Skip to content

Commit 4677611

Browse files
committed
DOCSP-50754: Add agg tutorials links (#277)
* DOCSP-50754: Add agg tutorials links * redirects * build error (cherry picked from commit ca76a2a)
1 parent 897a35c commit 4677611

File tree

9 files changed

+24
-1347
lines changed

9 files changed

+24
-1347
lines changed

config/redirects

Lines changed: 13 additions & 6 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}
3-
define: versions v4.0 v4.1 v4.2 v4.3 v4.4 v4.5 v4.6 v4.7 v4.8 v4.9 4.10 4.11 4.12 master
3+
define: server https://www.mongodb.com/docs/manual
4+
define: versions v4.0 v4.1 v4.2 v4.3 v4.4 v4.5 v4.6 v4.7 v4.8 v4.9 v4.10 v4.11 v4.12 v4.13 master
45

56
symlink: current -> master
67

@@ -169,10 +170,16 @@ raw: ${prefix}/security/authentication/kerberos/ -> ${base}/current/security/aut
169170
[*-master]: ${prefix}/${version}/indexes/wildcard-index/ -> ${base}/${version}/indexes/
170171
[*-master]: ${prefix}/${version}/indexes/clustered-index/ -> ${base}/${version}/indexes/
171172

173+
# Aggregation tutorials redirects
172174
[*-master]: ${prefix}/${version}/aggregation/aggregation-tutorials/ -> ${base}/${version}/aggregation/
173-
[*-master]: ${prefix}/${version}/aggregation/aggregation-tutorials/filtered-subset/ -> ${base}/${version}/aggregation/filtered-subset/
174-
[*-master]: ${prefix}/${version}/aggregation/aggregation-tutorials/group-total/ -> ${base}/${version}/aggregation/group-total/
175-
[*-master]: ${prefix}/${version}/aggregation/aggregation-tutorials/multi-field-join/ -> ${base}/${version}/aggregation/multi-field-join/
176-
[*-master]: ${prefix}/${version}/aggregation/aggregation-tutorials/one-to-one-join/ -> ${base}/${version}/aggregation/one-to-one-join/
177-
[*-master]: ${prefix}/${version}/aggregation/aggregation-tutorials/unpack-arrays/ -> ${base}/${version}/aggregation/unpack-arrays/
175+
[*-master]: ${prefix}/${version}/aggregation/aggregation-tutorials/filtered-subset/ -> ${server}/tutorial/aggregation-examples/filtered-subset/
176+
[*-master]: ${prefix}/${version}/aggregation/filtered-subset/ -> ${server}/tutorial/aggregation-examples/filtered-subset/
177+
[*-master]: ${prefix}/${version}/aggregation/aggregation-tutorials/group-total/ -> ${server}/tutorial/aggregation-examples/group-and-total/
178+
[*-master]: ${prefix}/${version}/aggregation/group-total/ -> ${server}/tutorial/aggregation-examples/group-and-total/
179+
[*-master]: ${prefix}/${version}/aggregation/aggregation-tutorials/multi-field-join/ -> ${server}/tutorial/aggregation-examples/multi-field-join/
180+
[*-master]: ${prefix}/${version}/aggregation/multi-field-join/ -> ${server}/tutorial/aggregation-examples/multi-field-join/
181+
[*-master]: ${prefix}/${version}/aggregation/aggregation-tutorials/one-to-one-join/ ->${server}/tutorial/aggregation-examples/one-to-one-join/
182+
[*-master]: ${prefix}/${version}/aggregation/one-to-one-join/ -> ${server}/tutorial/aggregation-examples/one-to-one-join/
183+
[*-master]: ${prefix}/${version}/aggregation/aggregation-tutorials/unpack-arrays/ -> ${server}/tutorial/aggregation-examples/unpack-arrays/
184+
[*-master]: ${prefix}/${version}/aggregation/unpack-arrays/ -> ${server}/tutorial/aggregation-examples/unpack-arrays/
178185

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

@@ -281,41 +277,6 @@ To learn more about explaining MongoDB operations, see
281277
:manual:`Explain Output </reference/explain-results/>` and
282278
:manual:`Query Plans. </core/query-plans/>`
283279

284-
Aggregation Tutorials
285-
~~~~~~~~~~~~~~~~~~~~~
286-
287-
To view step-by-step explanations of common aggregation tasks, see
288-
the following tutorials:
289-
290-
- :ref:`pymongo-aggregation-filtered-subset`
291-
- :ref:`pymongo-aggregation-group-total`
292-
- :ref:`pymongo-aggregation-arrays`
293-
- :ref:`pymongo-aggregation-one-to-one`
294-
- :ref:`pymongo-aggregation-multi-field`
295-
296-
Aggregation tutorials provide detailed explanations of common
297-
aggregation tasks in a step-by-step format. The tutorials are adapted
298-
from examples in the `Practical MongoDB Aggregations book
299-
<https://www.practical-mongodb-aggregations.com/>`__ by Paul Done.
300-
301-
Each tutorial includes the following sections:
302-
303-
- **Introduction**, which describes the purpose and common use cases of the
304-
aggregation type. This section also describes the example and desired
305-
outcome that the tutorial demonstrates.
306-
307-
- **Before You Get Started**, which describes the necessary databases,
308-
collections, and sample data that you must have before building the
309-
aggregation pipeline and performing the aggregation.
310-
311-
- **Tutorial**, which describes how to build and run the aggregation
312-
pipeline. This section describes each stage of the completed
313-
aggregation tutorial, and then explains how to run and interpret the
314-
output of the aggregation.
315-
316-
At the end of each aggregation tutorial, you can find a link to a fully
317-
runnable Python code file that you can run in your environment.
318-
319280
API Documentation
320281
~~~~~~~~~~~~~~~~~
321282

source/aggregation/filtered-subset.txt

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

0 commit comments

Comments
 (0)