Docsp 27977 - documents stage (#334)

* wip

* remove css

* Apply suggestions from code review

* mk feedback

---------

Co-authored-by: Rea Rustagi <[email protected]>

Author: mongoKart

source/fundamentals/builders/aggregates.txt

@@ -2,8 +2,6 @@
 Aggregates Builders
 ===================
 
-.. default-domain:: mongodb
-
 .. contents:: On this page
    :local:
    :backlinks: none
@@ -73,7 +71,6 @@ The following example creates a pipeline stage that matches all documents where
    :dedent:
 
 
-
 Project
 -------
 
@@ -110,6 +107,34 @@ into a new field called ``rating``, effectively renaming the field.
    :dedent:
 
 
+Documents
+---------
+
+Use the ``documents()`` method to create a
+:manual:`$documents </reference/operator/aggregation/documents/>`
+pipeline stage that returns literal documents from input values.
+
+.. important::
+
+   If you use a ``$documents`` stage in an aggregation pipeline, it must be the first 
+   stage in the pipeline.
+
+The following example creates a pipeline stage that creates 
+sample documents with a ``title`` field: 
+
+.. literalinclude:: /includes/fundamentals/code-snippets/builders/AggBuilders.java
+   :start-after: // begin documents
+   :end-before: // end documents
+   :language: java
+   :dedent:
+
+.. important::
+
+   If you use the ``documents()`` method to provide the input to an aggregation pipeline, 
+   you must call the ``aggregate()`` method on a database instead of on a 
+   collection.
+
+
 Sample
 ------
 
@@ -946,3 +971,4 @@ aggregation stage:
 
 Learn more about this helper from the
 `searchMeta() API documentation <{+api+}/apidocs/mongodb-driver-core/com/mongodb/client/model/Aggregates.html#searchMeta(com.mongodb.client.model.search.SearchCollector)>`__.
+

source/includes/fundamentals/code-snippets/builders/AggBuilders.java

@@ -302,4 +302,13 @@ private void matchStage() {
         match(eq("title", "The Shawshank Redemption"));
         // end match
     }
+
+    private void documents() {
+        // begin documents
+        documents(asList(
+                new Document("title", "The Shawshank Redemption"),
+                new Document("title", "Back to the Future"),
+                new Document("title", "Jurassic Park")));
+        // end documents
+    }
 }

source/index.txt

@@ -161,8 +161,7 @@ Take the free online course taught by MongoDB instructors
 
 .. list-table::
 
-   * - .. cssclass:: bordered-figure
-       .. figure:: /includes/figures/M220J_hero.jpg
+   * - .. figure:: /includes/figures/M220J_hero.jpg
           :alt: MongoDB Java Course Hero
 
      - `Using MongoDB with Java <https://learn.mongodb.com/learning-paths/using-mongodb-with-java>`_