Docsp 28122 backport v5 (#3204)

* DOCSP-14384 fix first last accumulators (#2231)

* Removed first and last array operator topics

* Removed links to  and  array operator topics

* Added array behavior to existing  and  topics

* Cleaned up links

* Removed includes, started work on making ref sections consistent

* Fixed aggregation accumulators landing page entries for first and last

* Fixed descriptions for first and last

* PR feedback and testing a ref

* Updates to link cleanup

* Reduced number of links per style guidelines

* Parallel cleanup on headings and structure

* Latest cleanup on  and

* Fixed firstN summary in aggregation reference

* Committing cleaned branch

* Restoring first/last updates to manually back out time series changes

* Removed draft content for time series changes

* Added first/last accumulator links to ArrayElemAt to replace expression links

* Rebuilding

* Manual merge resolution

* Removed first/last expression listings

* Removed first/last expression listings--amend

* Rebuild

* Broken ref fix

Author: nvillahermosa-mdb

source/includes/extracts-agg-operators.yaml

@@ -31,12 +31,12 @@ content: |
 
       * - :expression:`$atan2`
         - Returns the inverse tangent (arc tangent) of ``y / x`` in
-          radians, where ``y`` and ``x`` are the first and second 
-          values passed to the expression respectively.
+          radians, where ``y`` and ``x`` are the first and second values
+          passed to the expression respectively.
 
       * - :expression:`$asinh`
-        - Returns the inverse hyperbolic sine (hyperbolic arc sine) of a 
-          value in radians.
+        - Returns the inverse hyperbolic sine (hyperbolic arc sine) of
+          a value in radians.
 
       * - :expression:`$acosh`
         - Returns the inverse hyperbolic cosine (hyperbolic arc cosine)
@@ -176,10 +176,6 @@ content: |
 
         - Selects a subset of the array to return an array with only
           the elements that match the filter condition.
-
-      * - :expression:`$first`
-
-        - Returns the first array element. Distinct from :group:`$first` accumulator.
   
       * - :expression:`$in`
 
@@ -196,10 +192,6 @@ content: |
 
         - Determines if the operand is an array. Returns a boolean.
 
-      * - :expression:`$last`
-
-        - Returns the last array element. Distinct from :group:`$last` accumulator.
-
       * - :expression:`$map`
 
         - Applies a subexpression to each element of an array and
@@ -996,21 +988,17 @@ content: |
 
       * - :group:`$first`
 
-        - Returns a value from the first document for each group. Order
-          is only defined if the documents are sorted.
-          
-          Distinct from the :expression:`$first` array operator.
+        - Returns the result of an :ref:`expression
+          <aggregation-expressions>` for the first document in a group.
 
           .. versionchanged:: 5.0
 
              Available in the :pipeline:`$setWindowFields` stage.
 
       * - :group:`$last`
 
-        - Returns a value from the last document for each group. Order
-          is only defined if the documents are sorted.
-          
-          Distinct from the :expression:`$last` array operator.
+        - Returns the result of an :ref:`expression
+          <aggregation-expressions>` for the last document in a group.
 
           .. versionchanged:: 5.0
 
@@ -1092,6 +1080,16 @@ content: |
         - Returns an average of the specified expression or list of
           expressions for each document. Ignores non-numeric values.
 
+      * - :group:`$first`
+
+        - Returns the result of an :ref:`expression
+          <aggregation-expressions>` for the first document in a group.
+
+      * - :group:`$last`
+
+        - Returns the result of an :ref:`expression
+          <aggregation-expressions>` for the last document in a group.
+
       * - :group:`$max`
 
         - Returns the maximum of the specified expression or list of
@@ -1211,9 +1209,9 @@ content: |
 
       * - :group:`$first`
 
-        - Returns the value that results from applying an
-          :ref:`expression <aggregation-expressions>` to the first
-          document in a group or :ref:`window <setWindowFields-window>`.
+        - Returns the result of an :ref:`expression
+          <aggregation-expressions>` for the first document in a group
+          or :ref:`window <setWindowFields-window>`.
 
           .. versionchanged:: 5.0
 
@@ -1227,9 +1225,9 @@ content: |
 
       * - :group:`$last`
 
-        - Returns the value that results from applying an
-          :ref:`expression <aggregation-expressions>` to the last
-          document in a group or :ref:`window <setWindowFields-window>`.
+        - Returns the result of an :ref:`expression
+          <aggregation-expressions>` for the last document in a group
+          or :ref:`window <setWindowFields-window>`.
         
           .. versionchanged:: 5.0
 

source/includes/note-group-and-window-behavior.rst

@@ -374,8 +374,7 @@ Index of Expression Operators
    - :expression:`$eq`
    - :expression:`$exp`
    - :expression:`$filter`
-   - :expression:`$first` (array)
-   - :group:`$first` (accumulator)
+   - :group:`$first`
    - :expression:`$floor`
    - :expression:`$function`
    - :expression:`$getField`
@@ -392,8 +391,7 @@ Index of Expression Operators
    - :expression:`$isoDayOfWeek`
    - :expression:`$isoWeek`
    - :expression:`$isoWeekYear`
-   - :expression:`$last` (array)
-   - :group:`$last` (accumulator)
+   - :group:`$last`
    - :expression:`$let`
    - :expression:`$literal`
    - :expression:`$ln`

source/meta/aggregation-quick-reference.txt

@@ -15,8 +15,8 @@ Definition
 
 .. dbcommand:: collMod
 
-   :dbcommand:`collMod` makes it possible to add options to a collection
-   or to modify view definitions.
+   :dbcommand:`collMod` makes it possible to add options to a 
+   collection or to modify view definitions.
 
    .. |method| replace:: :method:`~db.collection.hideIndex` and
       :method:`~db.collection.unhideIndex` helper methods

source/reference/command/collMod.txt

@@ -475,17 +475,6 @@ Alphabetical Listing of Expression Operators
        .. versionchanged:: 5.0
 
           Available in :pipeline:`$setWindowFields` stage.
-   
-       Distinct from the :expression:`$first` array operator.
-
-
-   * - :expression:`$first`
-
-     - Returns the first array element.
-   
-       .. versionadded:: 4.4
-   
-       Distinct from the :group:`$first` accumulator.
 
    * - :expression:`$floor`
 
@@ -607,18 +596,6 @@ Alphabetical Listing of Expression Operators
        .. versionchanged:: 5.0
 
           Available in :pipeline:`$setWindowFields` stage.
-   
-       Distinct from the :expression:`$last` array operator.
-   
-
-   * - :expression:`$last`
-
-     - Returns the last array element.
-      
-       .. versionadded:: 4.4
-   
-       Distinct from the :group:`$last` accumulator.
-
 
    * - :expression:`$let`
 
@@ -1185,7 +1162,6 @@ Alphabetical Listing of Expression Operators
    /reference/operator/aggregation/expMovingAvg
    /reference/operator/aggregation/filter
    /reference/operator/aggregation/first
-   /reference/operator/aggregation/first-array-element
    /reference/operator/aggregation/floor
    /reference/operator/aggregation/function
    /reference/operator/aggregation/getField
@@ -1204,7 +1180,6 @@ Alphabetical Listing of Expression Operators
    /reference/operator/aggregation/isoWeek
    /reference/operator/aggregation/isoWeekYear
    /reference/operator/aggregation/last
-   /reference/operator/aggregation/last-array-element
    /reference/operator/aggregation/let
    /reference/operator/aggregation/literal
    /reference/operator/aggregation/ln

source/reference/operator/aggregation.txt

@@ -112,10 +112,10 @@ The operation returns the following results:
 See Also
 --------
 
-- :expression:`$first`
+- :expression:`$slice`
 
-- :expression:`$last`
+- :group:`$first`
 
-- :expression:`$slice`
+- :group:`$last`
 
 - :ref:`agg-quick-ref-operator-array`