DOCSP-50752: agg tutorial link (#1167)

* DOCSP-50752: agg tutorial link

* shift redirects

* shift redirects

* shift redirects

(cherry picked from commit c2de22c)
(cherry picked from commit c60b569)

Author: rustagir

snooty.toml

@@ -9,23 +9,25 @@ intersphinx = [
 toc_landing_pages = [
     "/get-started",
     "/connect",
-    "/aggregation",
     "/security",
     "/security/authentication",
     "/data-formats",
     "/connect/connection-options",
     "/crud",
     "/crud/update",
     "/crud/transactions",
-    "/monitoring-and-logging"
+    "/monitoring-and-logging",
 ]
 sharedinclude_root = "https://raw.githubusercontent.com/10gen/docs-shared/main/"
 
 [constants]
-version = "6.15"
+
 api = "https://mongodb.github.io/node-mongodb-native/{+version+}"
 driver-long = "MongoDB Node.js driver"
 driver-short = "Node.js driver"
 mdb-server = "MongoDB Server"
 min-node-version = "v16.20.1"
 stable-api = "Stable API"
+vector-search = "Atlas Vector Search"
+language = "JavaScript"
+environment = "Node.js"

source/aggregation.txt

@@ -15,14 +15,6 @@ Aggregation
    :depth: 2
    :class: singlecol
 
-.. toctree::
-
-   Filtered Subset </aggregation/filtered-subset/>
-   Group & Total </aggregation/group-total/>
-   Unpack Arrays & Group </aggregation/unpack-arrays/>
-   One-to-One Join </aggregation/one-to-one-join/>
-   Multi-Field Join </aggregation/multi-field-join/>
-
 .. _nodejs-aggregation-overview:
 
 Overview
@@ -36,6 +28,14 @@ and summarized results in MongoDB. MongoDB's aggregation framework
 allows you to create a pipeline that consists of one or more stages,
 each of which performs a specific operation on your data.
 
+.. _node-aggregation-tutorials:
+
+.. sharedinclude:: dbx/agg-tutorials-manual-tip.rst
+
+   .. replacement:: language
+
+      :guilabel:`{+environment+}`
+
 Analogy
 ~~~~~~~
 
@@ -143,112 +143,9 @@ This example produces the following output:
 
 For more information, see the `aggregate() API documentation <{+api+}/classes/Collection.html#aggregate>`__.
 
-.. _node-aggregation-tutorials-landing:
-.. _node-aggregation-tutorials:
-
-Aggregation Tutorials
----------------------
-
-Aggregation tutorials provide detailed explanations of common
-aggregation tasks in a step-by-step format. The tutorials are adapted
-from examples in the `Practical MongoDB Aggregations book
-<https://www.practical-mongodb-aggregations.com/>`__ by Paul Done.
-
-Each tutorial includes the following sections:
-
-- **Introduction**, which describes the purpose and common use cases of the
-  aggregation type. This section also describes the example and desired
-  outcome that the tutorial demonstrates.
-
-- **Before You Get Started**, which describes the necessary databases,
-  collections, and sample data that you must have before building the
-  aggregation pipeline and performing the aggregation.
-
-- **Tutorial**, which describes how to build and run the aggregation
-  pipeline. This section describes each stage of the completed
-  aggregation tutorial, and then explains how to run and interpret the
-  output of the aggregation.
-
-At the end of each aggregation tutorial, you can find a link to a fully
-runnable Node.js code file that you can run in your environment.
-
-.. tip::
-
-   To learn more about performing aggregations, see the
-   :ref:`node-aggregation` guide.
-
-.. _node-agg-tutorial-template-app:
-
-Aggregation Template App
-~~~~~~~~~~~~~~~~~~~~~~~~
-
-Before you begin following an aggregation tutorial, you must set up a
-new Node.js app. You can use this app to connect to a MongoDB
-deployment, insert sample data into MongoDB, and run the aggregation
-pipeline in each tutorial.
-
-.. tip:: 
-
-   To learn how to install the driver and connect to MongoDB,
-   see the :ref:`node-get-started-download-and-install` and
-   :ref:`node-get-started-create-deployment` steps of the
-   Quick Start guide.
-
-Once you install the driver, create a file called
-``agg_tutorial.js``. Paste the following code in this file to create an
-app template for the aggregation tutorials:
-
-.. literalinclude:: /includes/aggregation/template-app.js
-   :language: javascript
-   :copyable: true
-
-.. important::
-
-   In the preceding code, read the code comments to find the sections of
-   the code that you must modify for the tutorial you are following.
-
-   If you attempt to run the code without making any changes, you will
-   encounter a connection error.
-
-For every tutorial, you must replace the connection string placeholder with
-your deployment's connection string.
-
-.. tip::
-
-   To learn how to locate your deployment's connection string, see the
-   :ref:`node-get-started-connection-string` step of the Quick Start guide.
-
-For example, if your connection string is
-``"mongodb+srv://mongodb-example:27017"``, your connection string assignment resembles
-the following:
-
-.. code-block:: javascript
-   :copyable: false
-
-   const uri = "mongodb+srv://mongodb-example:27017";
-
-To run the completed file after you modify the template for a
-tutorial, run the following command in your shell:
-
-.. code-block:: bash
-
-   node agg_tutorial.js
-
-Available Tutorials
-~~~~~~~~~~~~~~~~~~~
-
-- :ref:`node-aggregation-filtered-subset`
-- :ref:`node-aggregation-group-total`
-- :ref:`node-aggregation-arrays`
-- :ref:`node-aggregation-one-to-one`
-- :ref:`node-aggregation-multi-field`
-
 Additional Examples
 ~~~~~~~~~~~~~~~~~~~
 
-To view step-by-step explanations of common aggregation tasks, see the
-:ref:`node-aggregation-tutorials-landing`.
-
 You can find another aggregation pipeline example in the `Aggregation
 Framework with Node.js Tutorial
 <https://www.mongodb.com/blog/post/quick-start-nodejs--mongodb--how-to-analyze-data-using-the-aggregation-framework>`_