DOCS-15018 updating all references of maxN -> maxN-array-element (#245)

* DOCS-15018 updating all references of maxN -> maxN-array-element

* Add (Array Operator) to 5.2 release notes topN operators with name overlap

* undo previous 5.2 edits

* Adding distinct notes, reorg TOC entries, changed links on release notes

* ->

Author: ianf-mongodb

source/includes/extracts-agg-operators.yaml

@@ -184,6 +184,7 @@ content: |
       * - :expression:`$firstN`
 
         - Returns a specified number of elements from the beginning of an array.
+          Distinct from the :group:`$firstN` accumulator.
   
       * - :expression:`$in`
 
@@ -207,6 +208,7 @@ content: |
       * - :expression:`$lastN`
 
         - Returns a specified number of elements from the end of an array.
+          Distinct from the :group:`$lastN` accumulator.
 
       * - :expression:`$map`
 
@@ -217,10 +219,12 @@ content: |
       * - :expression:`$maxN`
 
         - Returns the ``n`` largest values in an array.
+          Distinct from the :group:`$maxN` accumulator.
 
       * - :expression:`$minN`
 
         - Returns the ``n`` smallest values in an array.
+          Distinct from the :group:`$minN` accumulator.
 
       * - :expression:`$objectToArray`
 

source/reference/operator/aggregation.txt

@@ -516,6 +516,7 @@ Alphabetical Listing of Expression Operators
 
      - Returns a specified number of elements from the beginning of an 
        array.
+       Distinct from the :group:`$firstN` accumulator.
 
        .. versionadded:: 5.2
 
@@ -654,6 +655,7 @@ Alphabetical Listing of Expression Operators
    * - :expression:`$lastN`
 
      - Returns a specified number of elements from the end of an array.
+       Distinct from the :group:`$lastN` accumulator.
 
        .. versionadded:: 5.2 
 
@@ -725,6 +727,7 @@ Alphabetical Listing of Expression Operators
    * - :expression:`$maxN`
 
      - Returns the ``n`` largest values in an array.
+       Distinct from the :group:`$maxN` accumulator.
 
        .. versionadded:: 5.2
 
@@ -751,6 +754,7 @@ Alphabetical Listing of Expression Operators
    * - :expression:`$minN`
 
      - Returns the ``n`` smallest values in an array.
+       Distinct from the :group:`$minN` accumulator.
 
        .. versionadded:: 5.2
 
@@ -1277,8 +1281,8 @@ Alphabetical Listing of Expression Operators
    /reference/operator/aggregation/expMovingAvg
    /reference/operator/aggregation/filter
    /reference/operator/aggregation/first
-   /reference/operator/aggregation/firstN
    /reference/operator/aggregation/first-array-element
+   /reference/operator/aggregation/firstN-array-element
    /reference/operator/aggregation/floor
    /reference/operator/aggregation/function
    /reference/operator/aggregation/getField
@@ -1297,8 +1301,8 @@ Alphabetical Listing of Expression Operators
    /reference/operator/aggregation/isoWeek
    /reference/operator/aggregation/isoWeekYear
    /reference/operator/aggregation/last
-   /reference/operator/aggregation/lastN
    /reference/operator/aggregation/last-array-element
+   /reference/operator/aggregation/lastN-array-element
    /reference/operator/aggregation/let
    /reference/operator/aggregation/literal
    /reference/operator/aggregation/ln
@@ -1310,11 +1314,11 @@ Alphabetical Listing of Expression Operators
    /reference/operator/aggregation/ltrim
    /reference/operator/aggregation/map
    /reference/operator/aggregation/max
-   /reference/operator/aggregation/maxN
+   /reference/operator/aggregation/maxN-array-element
    /reference/operator/aggregation/mergeObjects
    /reference/operator/aggregation/meta
    /reference/operator/aggregation/min
-   /reference/operator/aggregation/minN
+   /reference/operator/aggregation/minN-array-element
    /reference/operator/aggregation/millisecond
    /reference/operator/aggregation/minute
    /reference/operator/aggregation/mod

source/reference/operator/aggregation/firstN.txt renamed to source/reference/operator/aggregation/firstN-array-element.txt

@@ -39,22 +39,26 @@ MongoDB 5.2 introduces the following aggregation operators:
      - Returns an aggregation of the bottom ``n`` elements within a group,
        according to the specified sort order.
 
-   * - :expression:`$firstN`
+   * - :expression:`$firstN (array operator) <$firstN>`
      - Returns a specified number of elements from the beginning of an 
        array.
+       Distinct from the :group:`$firstN` accumulator.
 
-   * - :expression:`$lastN`
+   * - :expression:`$lastN (array operator) <$lastN>`
      - Returns a specified number of elements from the end of an 
        array.
+       Distinct from the :group:`$lastN` accumulator.
 
    * - :group:`$locf`
      - .. include:: /includes/fact-locf-description.rst
 
-   * - :expression:`$maxN`
+   * - :expression:`$maxN (array operator) <$maxN>`
      - Returns the ``n`` largest values in an array.
+       Distinct from the :group:`$maxN` accumulator.
 
-   * - :expression:`$minN`
+   * - :expression:`$minN (array operator) <$minN>`
      - Returns the ``n`` smallest values in an array.
+       Distinct from the :group:`$minN` accumulator.
 
    * - :group:`$top`
      - Returns the top element within a group according to the specified