DOCSP 32407 moving aggregation quick reference page (#5098) (#5112)

ltran-mdb2 · web-flow · commit e8af332f860d · 2023-10-19T12:20:17.000-04:00
* DOCSP 32407 moving aggregation quick reference page (#5098) * DOCSP-32407 moving aggregation quick reference page * DOCSP-32407 updating redirects * DOCSP-32407 updating redirects * DOCSP-32407 updating page references * DOCSP-32407 updating page references * DOCSP-32407 updating page references * DOCSP-32407 updating page references * DOCSP-32407 changing doc to ref * DOCSP-32407 changing doc to ref * DOCSP-32407-v6.0-backport build errors
diff --git a/config/redirects b/config/redirects
@@ -2413,4 +2413,7 @@ raw: ${prefix}/${version}/applications/drivers -> ${base}/drivers/
 
 # Fixing 
 raw: https://api.mongodb.com/python/current/ -> ${base}/drivers/python/
-raw: https://mongodb.github.io/mongo-java-driver/ -> ${base}/drivers/java/sync/current/
+raw: https://mongodb.github.io/mongo-java-driver/ -> ${base}/drivers/java/sync/current/
+
+# DOCSP-32407
+[v4.2-*]: ${prefix}/${version}/meta/aggregation-quick-reference/ -> ${prefix}/${version}/reference/aggregation-quick-reference/
diff --git a/source/includes/fact-use-aggregation-not-map-reduce.rst b/source/includes/fact-use-aggregation-not-map-reduce.rst
@@ -5,8 +5,8 @@ deprecated:
   :doc:`aggregation pipeline </core/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/reference/aggregation-quick-reference.txt b/source/reference/aggregation-quick-reference.txt
diff --git a/source/reference/aggregation.txt b/source/reference/aggregation.txt
@@ -23,7 +23,7 @@ Aggregation Reference
 Aggregation Resources
 ---------------------
 
-:doc:`/meta/aggregation-quick-reference`
+:ref:`agg-pipeline-quick-ref`
    Quick reference card for aggregation pipeline.
 
 :doc:`/reference/operator/aggregation/interface`
@@ -55,7 +55,7 @@ Aggregation Resources
    :titlesonly:
    :hidden:
 
-   /meta/aggregation-quick-reference
+   /reference/aggregation-quick-reference
    /reference/operator/aggregation/interface
    /reference/aggregation-commands-comparison
    /reference/aggregation-variables
diff --git a/source/reference/map-reduce-to-aggregation-pipeline.txt b/source/reference/map-reduce-to-aggregation-pipeline.txt
@@ -8,8 +8,8 @@ An :doc:`aggregation pipeline </core/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
+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
@@ -237,8 +237,8 @@ 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
+Various map-reduce expressions can be rewritten using :ref:`aggregation
+pipeline operators <agg-pipeline-quick-ref>`, such as
 :pipeline:`$group`, :pipeline:`$merge`, and others, without requiring
 custom functions. However, for illustrative purposes, the following
 examples provide both alternatives.
diff --git a/source/reference/operator/aggregation.txt b/source/reference/operator/aggregation.txt
@@ -1,7 +1,9 @@
-.. ensure that the changes to this text are reflected in /reference/operator/aggregation.txt
-.. ensure that the changes to this text are reflected in /meta/aggregation-quick-reference.txt
-   with slight difference. Quick Reference contains information on different expressions,
-   such as field paths, expression objects, etc.
+.. Remember to update /reference/aggregation-quick-reference.txt too.
+    
+   Quick Reference contains information on different expressions, such
+   as field paths, and expression objects. Make appropriate edits.
+
+.. _aggregation-pipeline-operators:
 
 ==============================
 Aggregation Pipeline Operators
@@ -16,7 +18,7 @@ The aggregation pipeline operators are compatible with MongoDB Atlas and on-prem
 
 .. COMMENT - this page omits the sections on Expressions in general
    as well as Literals, Field Paths, and Expression Objects which
-   are in the meta/aggregation-quick-reference.txt.
+   are in the /reference/aggregation-quick-reference.txt.
    This page only focuses on operators.
 
 Compatibility
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
@@ -57,7 +57,7 @@ terms, functions, and concepts and the corresponding MongoDB
      - :pipeline:`$unionWith` (Available starting in MongoDB 4.4)
 
 For a list of all aggregation pipeline and expression operators, see
-:doc:`/meta/aggregation-quick-reference`.
+:ref:`agg-pipeline-quick-ref`.
 
 .. seealso::
 
@@ -445,6 +445,6 @@ the table assume the following conditions:
 .. seealso::
 
    - :doc:`/reference/sql-comparison`
-   - :doc:`/meta/aggregation-quick-reference`
+   - :ref:`agg-pipeline-quick-ref`
    - :method:`db.collection.aggregate()`
 
diff --git a/source/release-notes/4.4.txt b/source/release-notes/4.4.txt
@@ -626,8 +626,8 @@ write custom JavaScript expressions instead of relying on
 .. note::
 
    Even before version 4.4, various map-reduce expressions could also
-   be rewritten using :doc:`other aggregation pipeline operators
-   </meta/aggregation-quick-reference>`, such as :pipeline:`$group`,
+   be rewritten using :ref:`other aggregation pipeline operators
+   <agg-pipeline-quick-ref>`, such as :pipeline:`$group`,
    :pipeline:`$merge`, etc., without requiring custom functions.
    
 For more information, see
diff --git a/source/tutorial/map-reduce-examples.txt b/source/tutorial/map-reduce-examples.txt
@@ -16,8 +16,8 @@ Map-Reduce Examples
    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
+   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
