DOCSP-26358 replaces agg pipline doc directives (#2120)

jmd-mongo · web-flow · commit e409e60ca614 · 2022-11-08T09:32:05.000-08:00
diff --git a/source/core/aggregation-pipeline-limits.txt b/source/core/aggregation-pipeline-limits.txt
@@ -32,9 +32,9 @@ Number of Stages Restrictions
 
 .. versionchanged:: 5.0
 
-   MongoDB 5.0 limits the number of :doc:`aggregation pipeline stages
-   </reference/operator/aggregation-pipeline>` allowed in a single pipeline
-   to 1000.
+   MongoDB 5.0 limits the number of :ref:`aggregation pipeline stages
+   <aggregation-pipeline-operator-reference>` allowed in a single 
+   pipeline to 1000.
 
 .. _agg-memory-restrictions:
 
diff --git a/source/core/read-preference.txt b/source/core/read-preference.txt
@@ -229,7 +229,7 @@ Read Preference and Transactions
 Additional Considerations
 -------------------------
 
-For :doc:`aggregation pipeline </core/aggregation-pipeline>`
+For :ref:`aggregation pipeline <aggregation-pipeline>`
 operations that include the :pipeline:`$out` or :pipeline:`$merge`
 stages, the pipeline runs on the :term:`primary` member regardless of
 read preference setting.
diff --git a/source/core/sharded-cluster-query-router.txt b/source/core/sharded-cluster-query-router.txt
@@ -51,7 +51,7 @@ retrieves the results.
 
 .. versionchanged:: 3.6
 
-   For :doc:`aggregation operations </core/aggregation-pipeline>` that
+   For :ref:`aggregation operations <aggregation-pipeline>` that
    run on multiple shards, if the operations do not require running on
    the database's :term:`primary shard`, these operations may route the
    results back to the :binary:`~bin.mongos` where the results are then
diff --git a/source/core/views/create-view.txt b/source/core/views/create-view.txt
@@ -220,13 +220,12 @@ When you query a view:
 
 - MongoDB appends the client query to the underlying pipeline and
   returns the results of that combined pipeline to the client. MongoDB
-  may apply :doc:`aggregation pipeline optimizations
-  </core/aggregation-pipeline-optimization>` to the combined pipeline.
+  may apply :ref:`aggregation pipeline optimizations
+  <agg-pipeline-optimization>` to the combined pipeline.
 
-- The :doc:`aggregation pipeline optimizer
-  </core/aggregation-pipeline-optimization>` reshapes the view
-  aggregation pipeline stages to improve performance. The optimization
-  does not change the query results.
+- The aggregation pipeline optimizer reshapes the view aggregation 
+  pipeline stages to improve performance. The optimization does not 
+  change the query results.
 
 Resource Locking
 ~~~~~~~~~~~~~~~~
diff --git a/source/includes/collection-audit-event.rst b/source/includes/collection-audit-event.rst
@@ -4,5 +4,5 @@ view:
 - ``viewOn`` field with the database and collection for the view.
 
 - ``pipeline`` field with the
-  :doc:`aggregation pipeline </core/aggregation-pipeline>` definition
+  :ref:`aggregation pipeline <aggregation-pipeline>` definition
   for the view.
diff --git a/source/includes/fact-use-aggregation-not-map-reduce.rst b/source/includes/fact-use-aggregation-not-map-reduce.rst
@@ -2,11 +2,11 @@ Starting in MongoDB 5.0, :doc:`map-reduce </core/map-reduce>` is
 deprecated:
 
 - Instead of :doc:`map-reduce </core/map-reduce>`, you should use an
-  :doc:`aggregation pipeline </core/aggregation-pipeline>`. Aggregation
+  :ref:`aggregation pipeline <aggregation-pipeline>`. Aggregation
   pipelines provide better performance and usability than map-reduce.
 
-- You can rewrite map-reduce operations using :doc:`aggregation
-  pipeline stages </meta/aggregation-quick-reference>`, such as
+- You can rewrite map-reduce operations using :ref:`aggregation
+  pipeline stages <agg-pipeline-quick-ref>`, such as
   :pipeline:`$group`, :pipeline:`$merge`, and others. 
 
 - For map-reduce operations that require custom functionality, you can
diff --git a/source/query-api.txt b/source/query-api.txt
@@ -28,7 +28,7 @@ You can use the |query-api| to perform:
   or a MongoDB :driver:`driver </>`.
 
 - **Data transformations**. Use 
-  :doc:`aggregation pipelines </core/aggregation-pipeline>` to 
+  :ref:`aggregation pipelines <aggregation-pipeline>` to 
   reshape your data and perform calculations. 
 
 - **Document join support** Use :pipeline:`$lookup` and 
diff --git a/source/reference/command.txt b/source/reference/command.txt
@@ -62,7 +62,7 @@ Aggregation Commands
 
    * - :dbcommand:`aggregate`
 
-     - Performs :doc:`aggregation tasks </core/aggregation-pipeline>` such as :pipeline:`$group` using an aggregation pipeline.
+     - Performs :ref:`aggregation tasks <aggregation-pipeline>` such as :pipeline:`$group` using an aggregation pipeline.
 
    * - :dbcommand:`count`
 
diff --git a/source/reference/command/aggregate.txt b/source/reference/command/aggregate.txt
@@ -15,8 +15,8 @@ Definition
 
 .. dbcommand:: aggregate
 
-   Performs aggregation operation using the :doc:`aggregation pipeline
-   </reference/operator/aggregation-pipeline>`. The pipeline allows users 
+   Performs aggregation operation using the :ref:`aggregation pipeline
+   <aggregation-pipeline>`. The pipeline allows users 
    to process data from a collection or other source with a sequence of 
    stage-based manipulations.
 
@@ -88,8 +88,7 @@ arguments:
 
      - array
 
-     - An array of :doc:`aggregation pipeline stages
-       </reference/operator/aggregation-pipeline>` that process and
+     - An array of aggregation pipeline stages that process and
        transform the document stream as part of the aggregation
        pipeline.
 
diff --git a/source/reference/command/findAndModify.txt b/source/reference/command/findAndModify.txt
@@ -121,8 +121,8 @@ The command takes the following fields:
        - If passed a replacement document ``{ <field1>: <value1>, ...}``,
          the |operation| performs a replacement.
        
-       - Starting in MongoDB 4.2, if passed an :doc:`aggregation pipeline
-         </core/aggregation-pipeline>` ``[ <stage1>, <stage2>, ... ]``,
+       - Starting in MongoDB 4.2, if passed an :ref:`aggregation pipeline
+         <aggregation-pipeline>` ``[ <stage1>, <stage2>, ... ]``,
          |operation| modifies the document per the pipeline. The pipeline
          can consist of the following stages:
        
diff --git a/source/reference/command/nav-aggregation.txt b/source/reference/command/nav-aggregation.txt
@@ -22,7 +22,7 @@ Aggregation Commands
 
    * - :dbcommand:`aggregate`
 
-     - Performs :doc:`aggregation tasks </core/aggregation-pipeline>` such as :pipeline:`$group` using an aggregation pipeline.
+     - Performs :ref:`aggregation tasks <aggregation-pipeline>` such as :pipeline:`$group` using an aggregation pipeline.
 
    * - :dbcommand:`count`
 
diff --git a/source/reference/command/serverStatus.txt b/source/reference/command/serverStatus.txt
@@ -1668,9 +1668,9 @@ metrics
 .. serverstatus:: metrics.aggStageCounters
 
    A document that reports on the use of
-   :doc:`aggregation pipeline stages
-   </reference/operator/aggregation-pipeline/>`. The fields
-   in :serverstatus:`metrics.aggStageCounters` are the names of
+   :ref:`aggregation pipeline stages 
+   <aggregation-pipeline-operator-reference>`. The fields in 
+   :serverstatus:`metrics.aggStageCounters` are the names of 
    aggregation pipeline stages. For each pipeline stage,
    :dbcommand:`serverStatus` reports the number of times that stage
    has been executed.
diff --git a/source/reference/command/update.txt b/source/reference/command/update.txt
@@ -402,8 +402,8 @@ Update with an Aggregation Pipeline
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 Starting in MongoDB 4.2, the update statement field :ref:`u
-<update-command-u>` field can accept an :doc:`aggregation pipeline
-</core/aggregation-pipeline>` ``[ <stage1>, <stage2>, ... ]`` that
+<update-command-u>` field can accept an :ref:`aggregation pipeline
+<aggregation-pipeline>` ``[ <stage1>, <stage2>, ... ]`` that
 specifies the modifications to perform. The pipeline can consist of
 the following stages:
 
diff --git a/source/reference/map-reduce-to-aggregation-pipeline.txt b/source/reference/map-reduce-to-aggregation-pipeline.txt
@@ -4,13 +4,13 @@ Map-Reduce to Aggregation Pipeline
 
 .. default-domain:: mongodb
 
-An :doc:`aggregation pipeline </core/aggregation-pipeline>` provides
+An :ref:`aggregation pipeline <aggregation-pipeline>` provides
 better performance and usability than a :doc:`map-reduce
 </core/map-reduce>` operation.
 
-Map-reduce operations can be rewritten using :doc:`aggregation pipeline
-operators </meta/aggregation-quick-reference>`, such as
-:pipeline:`$group`, :pipeline:`$merge`, and others. 
+Map-reduce operations can be rewritten using :ref:`aggregation pipeline
+operators <agg-pipeline-quick-ref>`, such as :pipeline:`$group`, 
+:pipeline:`$merge`, and others. 
 
 For map-reduce operations that require custom functionality, MongoDB
 provides the :group:`$accumulator` and :expression:`$function`
@@ -237,11 +237,10 @@ shows an approximate translation of ``mapFunction`` using the
 Examples
 --------
 
-Various map-reduce expressions can be rewritten using :doc:`aggregation
-pipeline operators </meta/aggregation-quick-reference>`, such as
-:pipeline:`$group`, :pipeline:`$merge`, and others, without requiring
-custom functions. However, for illustrative purposes, the following
-examples provide both alternatives.
+Various map-reduce expressions can be rewritten using aggregation
+pipeline operators, such as :pipeline:`$group`, :pipeline:`$merge`, and 
+others, without requiring custom functions. However, for illustrative 
+purposes, the following examples provide both alternatives.
 
 .. _mr-to-agg-examples1:
 
diff --git a/source/reference/method.txt b/source/reference/method.txt
@@ -29,7 +29,7 @@ Collection
 
    * - :method:`db.collection.aggregate()`
 
-     - Provides access to the :doc:`aggregation pipeline </core/aggregation-pipeline>`.
+     - Provides access to the :ref:`aggregation pipeline <aggregation-pipeline>`.
 
    * - :method:`db.collection.bulkWrite()`
 
diff --git a/source/reference/method/db.collection.aggregate.txt b/source/reference/method/db.collection.aggregate.txt
@@ -37,8 +37,8 @@ Definition
         - array
    
         - A sequence of data aggregation operations or stages. See the
-          :doc:`aggregation pipeline operators
-          </reference/operator/aggregation-pipeline>` for details.
+          :ref:`aggregation pipeline operators <aggregation-pipeline>` 
+          for details.
           
           The method can still accept the pipeline stages as separate
           arguments instead of as elements in an array; however, if you do
diff --git a/source/reference/method/db.collection.findAndModify.txt b/source/reference/method/db.collection.findAndModify.txt
@@ -125,8 +125,8 @@ Definition
           - If passed a replacement document ``{ <field1>: <value1>, ...}``,
             the |operation| performs a replacement.
           
-          - Starting in MongoDB 4.2, if passed an :doc:`aggregation pipeline
-            </core/aggregation-pipeline>` ``[ <stage1>, <stage2>, ... ]``,
+          - Starting in MongoDB 4.2, if passed an :ref:`aggregation pipeline
+            <aggregation-pipeline>` ``[ <stage1>, <stage2>, ... ]``,
             |operation| modifies the document per the pipeline. The pipeline
             can consist of the following stages:
           
diff --git a/source/reference/method/db.collection.updateMany.txt b/source/reference/method/db.collection.updateMany.txt
@@ -239,10 +239,9 @@ Update with an Aggregation Pipeline
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 Starting in MongoDB 4.2, the :method:`db.collection.updateMany()` method
-can accept an :doc:`aggregation pipeline
-</core/aggregation-pipeline>` ``[ <stage1>, <stage2>, ... ]`` that
-specifies the modifications to perform. The pipeline can consist of
-the following stages:
+can accept an :ref:`aggregation pipeline <aggregation-pipeline>`
+``[ <stage1>, <stage2>, ... ]`` that specifies the modifications to 
+perform. The pipeline can consist of the following stages:
 
 .. include:: /includes/list-update-agg-stages.rst
 
diff --git a/source/reference/method/db.collection.updateOne.txt b/source/reference/method/db.collection.updateOne.txt
@@ -230,8 +230,8 @@ Update with an Aggregation Pipeline
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 Starting in MongoDB 4.2, the :method:`db.collection.updateOne()` method
-can accept an :doc:`aggregation pipeline
-</core/aggregation-pipeline>` ``[ <stage1>, <stage2>, ... ]`` that
+can accept an :ref:`aggregation pipeline
+<aggregation-pipeline>` ``[ <stage1>, <stage2>, ... ]`` that
 specifies the modifications to perform. The pipeline can consist of
 the following stages:
 
diff --git a/source/reference/method/js-collection.txt b/source/reference/method/js-collection.txt
@@ -28,7 +28,7 @@ Collection Methods
 
    * - :method:`db.collection.aggregate()`
 
-     - Provides access to the :doc:`aggregation pipeline </core/aggregation-pipeline>`.
+     - Provides access to the :ref:`aggregation pipeline <aggregation-pipeline>`.
 
    * - :method:`db.collection.bulkWrite()`
 
diff --git a/source/reference/operator/aggregation.txt b/source/reference/operator/aggregation.txt
@@ -23,8 +23,8 @@ Expression Operators
 --------------------
 
 These expression operators are available to construct :ref:`expressions
-<aggregation-expressions>` for use in the :doc:`aggregation pipeline
-stages </reference/operator/aggregation-pipeline>`.
+<aggregation-expressions>` for use in the :ref:`aggregation pipeline
+stages <aggregation-pipeline>`.
 
 .. include:: /includes/intro-aggregation-operator-expressions.rst
 
diff --git a/source/reference/operator/aggregation/interface.txt b/source/reference/operator/aggregation/interface.txt
@@ -25,7 +25,7 @@ Aggregation Commands
 
    * - :dbcommand:`aggregate`
 
-     - Performs :doc:`aggregation tasks </core/aggregation-pipeline>` such as :pipeline:`$group` using an aggregation pipeline.
+     - Performs :ref:`aggregation tasks <aggregation-pipeline>` such as :pipeline:`$group` using an aggregation pipeline.
 
    * - :dbcommand:`count`
 
@@ -53,8 +53,8 @@ Aggregation Methods
 
    * - :method:`db.collection.aggregate()`
 
-     - Provides access to the :doc:`aggregation pipeline
-       </core/aggregation-pipeline>`.
+     - Provides access to the :ref:`aggregation pipeline
+       <aggregation-pipeline>`.
    
 
    * - :method:`db.collection.mapReduce()`
diff --git a/source/reference/operator/aggregation/merge.txt b/source/reference/operator/aggregation/merge.txt
@@ -28,8 +28,8 @@ Definition
 
 .. pipeline:: $merge
 
-   Writes the results of the :doc:`aggregation pipeline
-   </core/aggregation-pipeline>` to a specified collection. The
+   Writes the results of the :ref:`aggregation pipeline
+   <aggregation-pipeline>` to a specified collection. The
    :pipeline:`$merge` operator must be the **last** stage in the
    pipeline.
 
diff --git a/source/reference/operator/query/comment.txt b/source/reference/operator/query/comment.txt
@@ -32,7 +32,7 @@ Behavior
 You can use the :query:`$comment` with any expression taking a query
 predicate, such as the query predicate in
 :method:`db.collection.updateOne()` or in the :pipeline:`$match` stage
-of the :doc:`aggregation pipeline </meta/aggregation-quick-reference>`.
+of the :ref:`aggregation pipeline <agg-pipeline-quick-ref>`.
 For an example, see :ref:`ex-comment-agg-expression`.
 
 Examples
diff --git a/source/reference/sql-aggregation-comparison.txt b/source/reference/sql-aggregation-comparison.txt
@@ -14,7 +14,7 @@ SQL to Aggregation Mapping Chart
    files in the includes directory. To change the content of the
    tables, edit those files.
 
-The :doc:`aggregation pipeline </core/aggregation-pipeline>` allows
+The :ref:`aggregation pipeline <aggregation-pipeline>` allows
 MongoDB to provide native aggregation capabilities that corresponds to
 many common data aggregation operations in SQL.
 
diff --git a/source/release-notes/3.4.txt b/source/release-notes/3.4.txt
@@ -782,8 +782,8 @@ Aggregation
 New Aggregation Stage for Recursive Search
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-3.4 introduces a stage to the :doc:`aggregation pipeline
-</core/aggregation-pipeline>` that allows for recursive search.
+3.4 introduces a stage to the :ref:`aggregation pipeline
+<aggregation-pipeline>` that allows for recursive search.
 
 .. list-table::
    :header-rows: 1
@@ -812,8 +812,8 @@ documents, you may want to classify items by a single category, such as
 by the price range, or by multiple categories, such as by price range
 as well as separately by the departments.
 
-3.4 introduces stages to the :doc:`aggregation pipeline
-</core/aggregation-pipeline>` that allow for faceted search.
+3.4 introduces stages to the :ref:`aggregation pipeline
+<aggregation-pipeline>` that allow for faceted search.
 
 .. list-table::
    :header-rows: 1
@@ -852,8 +852,8 @@ as well as separately by the departments.
 New Aggregation Stages to Facilitate Reshaping Documents
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-3.4 introduces stages to the :doc:`aggregation pipeline
-</core/aggregation-pipeline>` that faciliate replacing documents as
+3.4 introduces stages to the :ref:`aggregation pipeline
+<aggregation-pipeline>` that faciliate replacing documents as
 well as adding new fields.
 
 .. list-table::
@@ -878,8 +878,8 @@ well as adding new fields.
 New Aggregation Stage to Count
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-3.4 introduces a new stage to the :doc:`aggregation pipeline
-</core/aggregation-pipeline>` that faciliate counting document.
+3.4 introduces a new stage to the :ref:`aggregation pipeline
+<aggregation-pipeline>` that faciliate counting document.
 
 .. list-table::
    :header-rows: 1
diff --git a/source/release-notes/3.6-compatibility.txt b/source/release-notes/3.6-compatibility.txt
@@ -244,7 +244,7 @@ Sorting with a Compound Sort Pattern on Multiple Array Fields with ``aggregate``
 ````````````````````````````````````````````````````````````````````````````````
 
 In MongoDB 3.6, when sorting in an
-:doc:`aggregation pipeline </core/aggregation-pipeline/>`, MongoDB can
+:ref:`aggregation pipeline <aggregation-pipeline>`, MongoDB can
 no longer sort documents which contain *parallel arrays* in the fields
 being sorted on. Arrays are considered parallel if they are sibling
 elements of the BSON object. Sort keys involving nested arrays are not
diff --git a/source/release-notes/5.0-compatibility.txt b/source/release-notes/5.0-compatibility.txt
@@ -398,8 +398,8 @@ Starting in MongoDB 5.0:
   :method:`db.collection.reIndex()` shell method may only be run on
   :term:`standalone` instances.
 
-- The number of :doc:`aggregation pipeline stages
-  </reference/operator/aggregation-pipeline>` allowed in a single
+- The number of :ref:`aggregation pipeline stages
+  <aggregation-pipeline-operator-reference>` allowed in a single
   pipeline is limited to 1000.
 
 - Dropping the final collection in a database (or dropping the database
diff --git a/source/sharding.txt b/source/sharding.txt
@@ -398,7 +398,7 @@ Practical MongoDB Aggregations E-Book
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 For more information on how sharding works with
-:doc:`aggregations </aggregation>`, read the sharding 
+:ref:`aggregations <aggregation-pipeline>`, read the sharding 
 chapter in the `Practical MongoDB Aggregations
 <https://www.practical-mongodb-aggregations.com/guides/sharding.html>`__
 e-book.
diff --git a/source/tutorial/manage-indexes.txt b/source/tutorial/manage-indexes.txt
@@ -203,7 +203,7 @@ sharded collections until you find the inconsistencies.
 
    The following pipeline is for MongoDB 4.2.4 and above.
 
-#. Define the following :doc:`aggregation pipeline </core/aggregation-pipeline>`:
+#. Define the following :ref:`aggregation pipeline <aggregation-pipeline>`:
 
    .. code-block:: javascript
 
diff --git a/source/tutorial/map-reduce-examples.txt b/source/tutorial/map-reduce-examples.txt
diff --git a/source/tutorial/perform-incremental-map-reduce.txt b/source/tutorial/perform-incremental-map-reduce.txt
diff --git a/source/tutorial/query-documents.txt b/source/tutorial/query-documents.txt
diff --git a/source/tutorial/troubleshoot-map-function.txt b/source/tutorial/troubleshoot-map-function.txt
diff --git a/source/tutorial/troubleshoot-reduce-function.txt b/source/tutorial/troubleshoot-reduce-function.txt
