DOCSP-12764 Add support for aggregation comments (#93)

* DOCSP-12764 Add support for aggregation comments

* DOCSP-12764 updates for tech review feedback

DOCSP-12764 updates

DOCSP-12764 updates

Author: kanchana-mongodb

source/admin/determine-query-status.txt

@@ -109,14 +109,33 @@ documents with the following fields:
 Examples 
 --------
 
-For the example below, suppose the following query is being run on the 
-``airbnb`` collection in the ``sample`` database described in the 
-:doc:`Getting Started tutorial 
-</tutorial/configure-database-collections/>`.
+For the example below, suppose one of the following queries is running on 
+the ``airbnb`` collection in the ``sample`` database described in the 
+:doc:`Getting Started tutorial </tutorial/configure-database-collections/>`.
 
-.. code-block:: json 
+.. tabs:: 
+
+   .. tab:: find Command
+      :tabid: find
+
+      .. code-block:: json 
+
+         db.airbnb.find( { "address.market" : "Porto", "review_scores.review_scores_rating": {$gt: 79}}).comment("Find properties in Porto")
+
+   .. tab:: aggregate Command
+      :tabid: aggregate
+
+      .. code-block:: json 
 
-   db.airbnb.find( { "address.market" : "Porto", "review_scores.review_scores_rating": {$gt: 79}})
+         db.airbnb.aggregate(
+           [ 
+             { 
+               $match: {
+                 "address.market": "Porto",
+                 "review_scores.review_scores_rating": {$gt: 79}
+               }
+             }
+           ], { comment: "Find properties in Porto" })
 
 The following example returns information on the previous query running on 
 the ``airbnb`` collection in the ``sample`` database: 
@@ -163,6 +182,7 @@ processed at the time that ``$currentOp`` was run.
 				"$gt" : 79
 			}
 		},
+		"comment" : "Find properties in Porto",
 		"lsid" : {
 			"id" : UUID("2211f8ac-56b2-4ba4-bb0c-2e5dd5b7cc21")
 		},

source/supported-unsupported/mql-support.txt

@@ -41,7 +41,9 @@ Aggregation Commands
 
      - The following limitations apply:
 
-       * Only the ``explain`` and ``cursor`` options are supported.
+       * Only the ``explain``, ``cursor``, and ``comment`` options are 
+         supported. Note that {+adl+} only supports type ``string`` for 
+         the ``comment`` option.
        * The ``$collStats``, ``$geoNear``, ``$graphLookup``,
          ``$indexStats``, ``$listLocalSessions``, and ``$listSessions``
          :manual:`aggregation pipeline stages