DOCSP-19834 Adding topN bottomN pages (#74)

* DOCSP-19834 topN bottomN

* Apply suggestions from code review

Suggestions PS3

Co-authored-by: jeff-allen-mongo <[email protected]>

* topN and extracts-agg-operators.yaml updates

* add .'s to extracts

* rearranging code blocks and descriptions

* fixing group build error and updating window function verbiage

* Apply suggestions from code review

Co-authored-by: jeff-allen-mongo <[email protected]>

* Added the example pipeline to each example ++

* added topn bottomN to alphabetical list on aggregation.txt

* fix indent on aggregation.txt

* attempting to fix build errors on aggregation.txt

* *

* address andrei comments 1

* fix builderrors?

* **

* address nit changes

* final adjustments

* add 5.2 release notes

* *

* alpha release table

Co-authored-by: jeff-allen-mongo <[email protected]>

Author: ianf-mongodb

source/includes/extracts-agg-operators.yaml

@@ -1008,6 +1008,16 @@ content: |
 
              Available in :pipeline:`$setWindowFields` stage.
 
+      * - :group:`$bottomN`
+
+        - Returns an aggregation of the bottom ``n`` fields within a group,
+          according to the specified sort order.
+
+          .. versionadded:: 5.2
+
+          Available in :pipeline:`$group` and
+          :pipeline:`$setWindowFields` stages.
+
       * - :group:`$count`
 
         - Returns the number of documents in a group.
@@ -1095,6 +1105,16 @@ content: |
 
              Available in :pipeline:`$setWindowFields` stage.
 
+      * - :group:`$topN`
+
+        - Returns an aggregation of the top ``n`` fields within a group,
+          according to the specified sort order.
+
+          .. versionadded:: 5.2
+
+          Available in :pipeline:`$group` and
+          :pipeline:`$setWindowFields` stages.
+
 ---
 ref: agg-operators-accumulators-project
 content: |
@@ -1180,6 +1200,16 @@ content: |
 
              Available in :pipeline:`$setWindowFields` stage.
 
+      * - :group:`$bottomN`
+
+        - Returns an aggregation of the bottom ``n`` fields within a group,
+          according to the specified sort order.
+
+          .. versionadded:: 5.2
+
+          Available in :pipeline:`$group` and
+          :pipeline:`$setWindowFields` stages.
+
       * - :group:`$count`
 
         - Returns the number of documents in the group or window.
@@ -1341,5 +1371,13 @@ content: |
           .. versionchanged:: 5.0
 
              Available in :pipeline:`$setWindowFields` stage.
+      
+      * - :group:`$topN`
+
+        - Returns an aggregation of the top ``n`` fields within a group,
+          according to the specified sort order.
+
+          .. versionadded:: 5.2
 
-...
+          Available in :pipeline:`$group` and
+          :pipeline:`$setWindowFields` stages.

source/includes/setWindowFields-operators.rst

@@ -2,11 +2,12 @@ These operators can be used with the :pipeline:`$setWindowFields` stage:
 
 .. _setWindowFields-accumulator-operators:
 
-- Accumulator operators: :group:`$addToSet`, :group:`$avg`,
-  :group:`$count`, :group:`$covariancePop`, :group:`$covarianceSamp`,
-  :group:`$derivative`, :group:`$expMovingAvg`, :group:`$integral`,
-  :group:`$max`, :group:`$min`, :group:`$push`, :group:`$stdDevSamp`,
-  :group:`$stdDevPop`, and :group:`$sum`.
+- Accumulator operators: :group:`$addToSet`, :group:`$avg`, 
+  :group:`$bottomN`, :group:`$count`, :group:`$covariancePop`, 
+  :group:`$covarianceSamp`, :group:`$derivative`, 
+  :group:`$expMovingAvg`, :group:`$integral`, :group:`$max`, 
+  :group:`$min`, :group:`$push`, :group:`$stdDevSamp`,
+  :group:`$stdDevPop`, :group:`$sum` and :group:`$topN`.
 
 .. _setWindowFields-gap-filling-operators:
 

source/reference/operator/aggregation.txt

@@ -265,6 +265,16 @@ Alphabetical Listing of Expression Operators
 
        .. versionadded:: 4.4
 
+   * - :group:`$bottomN`
+
+     - Returns an aggregation of the bottom ``n`` fields within a group,
+       according to the specified sort order.
+
+       .. versionadded:: 5.2
+
+       Available in :pipeline:`$group` and
+       :pipeline:`$setWindowFields` stages.
+
    * - :expression:`$bsonSize`
 
      - Returns the size in bytes of a given document (i.e. bsontype
@@ -1084,6 +1094,16 @@ Alphabetical Listing of Expression Operators
      - Converts value to an ObjectId.
 
 
+   * - :group:`$topN`
+
+     - Returns an aggregation of the top ``n`` fields within a group,
+       according to the specified sort order.
+   
+       .. versionadded:: 5.2
+
+       Available in :pipeline:`$group` and
+       :pipeline:`$setWindowFields` stages.
+
    * - :expression:`$toString`
 
      - Converts value to a string.