DOCS-11860: $facet stage size limits

Author: npentrel

source/core/aggregation-pipeline-limits.txt

@@ -16,20 +16,14 @@ following limitations.
 Result Size Restrictions
 ------------------------
 
-.. versionchanged:: 3.6
-
-   MongoDB 3.6 removes the option for the :dbcommand:`aggregate`
-   command to return its results as a single document.
-
 The :dbcommand:`aggregate` command can either return a cursor or store
-the results in a collection. When returning a cursor or storing the
-results in a collection, each document in the result set is subject to
-the :limit:`BSON Document Size` limit, currently 16 megabytes; if any
-single document exceeds the :limit:`BSON Document Size` limit, the
-command produces an error. The limit only applies to the returned
-documents; during the pipeline processing, the documents may exceed this
-size. The :method:`db.collection.aggregate()` method returns a cursor by
-default.
+the results in a collection. Each document in the result set is subject
+to the 16 megabyte :limit:`BSON Document Size limit <BSON Document
+Size>`. If any single document exceeds the :limit:`BSON Document Size
+limit <BSON Document Size>`, the aggregation produces an error. The
+limit only applies to the returned documents. During the pipeline
+processing, the documents may exceed this size. The
+:method:`db.collection.aggregate()` method returns a cursor by default.
 
 .. _agg-memory-restrictions:
 

source/includes/fact-agg-memory-limit.rst

@@ -36,8 +36,4 @@ Examples of stages that can spill to disk when :ref:`allowDiskUse
 If the results of one of your :pipeline:`$sort` pipeline stages exceed
 the limit, consider :ref:`adding a $limit stage <sort-limit-sequence>`.
 
-.. versionchanged:: 3.4
-
-   .. include:: /includes/fact-graphlookup-memory-restrictions.rst
-
 .. include:: /includes/extracts/4.2-changes-usedDisk.rst

source/reference/operator/aggregation/facet.txt

@@ -49,6 +49,18 @@ Definition
 
    Specify the output field name for each specified pipeline.
 
+Considerations
+--------------
+
+The output of the :pipeline:`$facet` stage is subject to the 16 megabyte
+:limit:`BSON Document Size limit <BSON Document Size>`. If the results
+of the :pipeline:`$facet` stage exceed the :limit:`BSON Document Size
+limit <BSON Document Size>`, the aggregation produces an error.
+
+.. seealso::
+
+   :doc:`/core/aggregation-pipeline-limits`
+
 Behavior
 --------