DOCSP-13653 Support background out to Atlas (#106)

Author: kanchana-mongodb

source/reference/pipeline/out.txt

@@ -387,9 +387,7 @@ Options
 
    * - ``background``
      - boolean
-     - For |out| to |s3| only.
-     
-       Flag to run aggregation operations in the background. If 
+     - Flag to run aggregation operations in the background. If 
        omitted, defaults to ``false``. When set to ``true``, {+adl+} 
        runs the queries in the background. 
 
@@ -509,7 +507,6 @@ Examples
          same ``sale-date`` value. |out| names each file using the
          documents' ``sale-date`` value converted to a string.
 
-
       *Multiple Fields from Documents*
 
       .. example::
@@ -608,46 +605,17 @@ Examples
          - A string value of part ID from the ``part-id`` field, and 
          - A forward slash (``/``).
 
-      **Run Query in the background**
-
-      The following example shows |out| syntax for running an 
-      aggregation pipeline that ends with the |out| stage in the 
-      background.
-
-      .. code-block:: json 
-         :emphasize-lines: 16
-
-         db.foo.aggregate([
-           {
-             "$out" : {
-               "s3" : {
-                 "bucket" : "my-s3-bucket",
-                 "region" : "us-east-1",
-                 "filename" : {
-                   "$toString" : "$sale-date"
-                 },
-                 "format" : {
-                   "name" : "json"
-                 }
-               }
-             }
-           }
-         ], { background: true })
-
-      |out| writes to |json| files in the root of the bucket in the 
-      background. Each |json| file contains all of the documents 
-      with the same ``sale-date`` value. |out| names each file using 
-      the documents' ``sale-date`` value converted to a string. 
-
    .. tab:: Atlas Cluster
       :tabid: atlas
 
-      .. example::
+      **Write to Collection on Atlas Cluster**
 
-         This |out| syntax sends the aggregated data to a
-         ``sampleDB.mySampleData`` collection in the |service| cluster
-         named ``myTestCluster``. The syntax doesn't specify a project
-         ID; |out| uses the ID of the project that contains your {+dl+}.
+      This |out| syntax sends the aggregated data to a 
+      ``sampleDB.mySampleData`` collection in the |service| cluster 
+      named ``myTestCluster``. The syntax doesn't specify a project ID; 
+      |out| uses the ID of the project that contains your {+dl+}.
+
+      .. example::
 
          .. code-block:: json
             :linenos:
@@ -662,6 +630,65 @@ Examples
               }
             }
 
+**Run Query in the background** 
+
+The following example shows |out| syntax for running an aggregation 
+pipeline that ends with the |out| stage in the background.
+
+.. tabs::
+   :hidden:
+
+   .. tab:: S3
+      :tabid: s3
+
+      .. example::
+
+         .. code-block:: json 
+            :emphasize-lines: 16
+
+            db.foo.aggregate([
+              {
+                "$out" : {
+                  "s3" : {
+                    "bucket" : "my-s3-bucket",
+                    "region" : "us-east-1",
+                    "filename" : {
+                      "$toString" : "$sale-date"
+                    },
+                    "format" : {
+                      "name" : "json"
+                    }
+                  }
+                }
+              }
+            ], { background: true })
+
+         |out| writes to |json| files in the root of the bucket in the 
+         background. Each |json| file contains all of the documents 
+         with the same ``sale-date`` value. |out| names each file using 
+         the documents' ``sale-date`` value converted to a string. 
+
+   .. tab:: Atlas Cluster
+      :tabid: atlas
+
+      .. example:: 
+
+         .. code-block:: json 
+            :emphasize-lines: 9
+            
+            {
+              "$out": {
+                "atlas": {
+                  "clusterName": "myTestCluster",
+                  "db": "sampleDB",
+                  "coll": "mySampleData"
+                }
+              }
+            }, { background: true })
+
+         |out| writes to ``sampleDB.mySampleData`` collection in the 
+         |service| cluster named ``myTestCluster`` in the background.
+
 .. _adl-out-stage-limitations:
 
 .. tabs::

source/supported-unsupported/mql-support.txt

@@ -45,9 +45,10 @@ Aggregation Commands
          and ``background`` options only. For the ``comment`` option, 
          {+adl+} supports only type ``string``. {+adl+} supports 
          ``{"background" : <boolean>}`` option for 
-         :ref:`adl-out-stage` to |s3| only. The ``background`` option 
-         is not available for other :manual:`aggregation pipeline 
-         stages </reference/operator/aggregation-pipeline>`. See 
+         :ref:`adl-out-stage` to |s3| and |service| cluster only. The 
+         ``background`` option is not available for other 
+         :manual:`aggregation pipeline stages 
+         </reference/operator/aggregation-pipeline>`. See 
          :ref:`$out Options <adl-out-stage-options>` for more 
          information.
        * {+adl+} supports :pipeline:`$geoNear` and