DOCSP-24712 lookup updates (FORPORT) (#1880)

jason-price-mongodb · jason-price-mongodb · web-flow · commit c3311eef310f · 2022-09-14T12:42:26.000-07:00
* DOCSP-24951 regex updates * DOCSP-24951 regex updates * DOCSP-24712 lookup updates (#1733) * DOCSP-24712-lookup-updates * DOCSP-24712-lookup-updates * DOCSP-24712-lookup-updates * DOCSP-24712-lookup-updates * DOCSP-24712-lookup-updates * DOCSP-24712-lookup-updates * DOCSP-24712-lookup-updates Co-authored-by: jason-price-mongodb <jshfjghsdfgjsdjh@aolsdjfhkjsdhfkjsdf.com> Co-authored-by: jason-price-mongodb <jshfjghsdfgjsdjh@aolsdjfhkjsdhfkjsdf.com>
diff --git a/source/includes/lookup-from.rst b/source/includes/lookup-from.rst
@@ -0,0 +1,3 @@
+``from`` is optional, you can use a :pipeline:`$documents` stage in a
+:pipeline:`$lookup` stage instead. For an example, see
+:ref:`documents-lookup-example`.
diff --git a/source/reference/operator/aggregation/documents.txt b/source/reference/operator/aggregation/documents.txt
@@ -75,8 +75,10 @@ stage.
      { _id: { min: 10, max: 10 }, count: 1 }
    ]
 
-Use :pipeline:`$documents` with :pipeline:`$lookup`
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+.. _documents-lookup-example:
+
+Use a ``$documents`` Stage in a ``$lookup`` Stage
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 Correlate documents in a collection with other data using
 :pipeline:`$documents` to modify :pipeline:`$lookup` output.
diff --git a/source/reference/operator/aggregation/lookup.txt b/source/reference/operator/aggregation/lookup.txt
@@ -67,8 +67,10 @@ The :pipeline:`$lookup` takes a document with these fields:
 
      - .. _lookup-eq-from:
      
-       Specifies the collection in the *same* database to perform
-       the join with.
+       Specifies the collection in the *same* database to perform the
+       join with.
+
+       .. include:: /includes/lookup-from.rst
 
        Starting in MongoDB 5.1, the collection specified in the ``from``
        parameter can be sharded.
@@ -186,6 +188,8 @@ The :pipeline:`$lookup` stage accepts a document with these fields:
        Specifies the collection in the *same* database to perform the
        join operation.
 
+       .. include:: /includes/lookup-from.rst
+
        Starting in MongoDB 5.1, the ``from`` collection can be sharded.
 
    * - :ref:`let <lookup-join-let>`
@@ -294,6 +298,8 @@ The :pipeline:`$lookup` accepts a document with these fields:
        Specifies the foreign collection in the *same* database to join
        to the local collection.
 
+       .. include:: /includes/lookup-from.rst
+       
        Starting in MongoDB 5.1, the ``from`` collection can be sharded.
 
    * - :ref:`localField

Original file line number	Diff line number	Diff line change
`@@ -0,0 +1,3 @@`
	`1`	+``from`` is optional, you can use a :pipeline:`$documents` stage in a
	`2`	+:pipeline:`$lookup` stage instead. For an example, see
	`3`	+:ref:`documents-lookup-example`.