Merge pull request #2985 from abinav2307/miscellaneous-query-third-pass-validation

JamesJBarnett · web-flow · commit aa13bbe61bcd · 2025-09-05T14:34:09.000-07:00
Miscellaneous query third pass validation
diff --git a/articles/cosmos-db/mongodb/vcore/operators/miscellaneous-query/$comment.md b/articles/cosmos-db/mongodb/vcore/operators/miscellaneous-query/$comment.md
@@ -1,13 +1,13 @@
 ---
   title: $comment
-  titleSuffix: Overview of the $comment operation in Azure Cosmos DB for MongoDB (vCore)
+  titleSuffix: Overview of the $comment operator in Azure Cosmos DB for MongoDB (vCore)
   description: The $comment operator adds a comment to a query to help identify the query in logs and profiler output.
   author: suvishodcitus
   ms.author: suvishod
   ms.service: azure-cosmos-db
   ms.subservice: mongodb-vcore
   ms.topic: language-reference
-  ms.date: 02/12/2025
+  ms.date: 09/04/2025
 ---
 
 # $comment
@@ -16,10 +16,10 @@ The `$comment` operator adds comments to queries to help identify them in logs a
 
 ## Syntax
 
-The syntax for the `$comment` operator is as follows:
-
 ```javascript
-{ $comment: <string> }
+{
+  $comment: <string>
+}
 ```
 
 ## Parameters
@@ -86,7 +86,7 @@ Consider this sample document from the stores collection.
 ```
 ### Example 1: Find stores with total sales over 100,000 and add a log comment for reference
 
-To find stores with total sales greater than 100,000 and includes a comment for easy identification in logs. 
+This query retrieves stores with total sales greater than 100,000 and includes a comment for easy identification in logs. 
 
 ```javascript
 db.stores.find(
@@ -95,18 +95,22 @@ db.stores.find(
 ).comment("Query to find high-performing stores")
 ```
 
-Sample Output
+This query returns the following result.
 
 ```json
-{
-  "_id": "40d6f4d7-50cd-4929-9a07-0a7a133c2e74",
-  "name": "Proseware, Inc. | Home Entertainment Hub - East Linwoodbury",
-  "sales": {
-    "totalSales": 151864
+[
+  {
+    "_id": "40d6f4d7-50cd-4929-9a07-0a7a133c2e74",
+    "name": "Proseware, Inc. | Home Entertainment Hub - East Linwoodbury",
+    "sales": {
+      "totalSales": 151864
+    }
   }
-}
+]
 ```
 
 ## Related content
 
 [!INCLUDE[Related content](../includes/related-content.md)]
+
+
diff --git a/articles/cosmos-db/mongodb/vcore/operators/miscellaneous-query/$natural.md b/articles/cosmos-db/mongodb/vcore/operators/miscellaneous-query/$natural.md
@@ -1,13 +1,13 @@
 ---
   title: $natural
-  titleSuffix: Overview of the $natural operation in Azure Cosmos DB for MongoDB (vCore)
+  titleSuffix: Overview of the $natural operator in Azure Cosmos DB for MongoDB (vCore)
   description: The $natural operator forces the query to use the natural order of documents in a collection, providing control over document ordering and retrieval.
   author: suvishodcitus
   ms.author: suvishod
   ms.service: azure-cosmos-db
   ms.subservice: mongodb-vcore
   ms.topic: reference
-  ms.date: 02/12/2025
+  ms.date: 09/04/2025
 ---
 
 # $natural
@@ -16,10 +16,10 @@ The `$natural` operator forces the query to use the natural order of documents i
 
 ## Syntax
 
-The syntax for the `$natural` operator in sort operations is as follows:
-
 ```javascript
-{ $natural: <1 | -1> }
+{
+  $natural: <1 | -1>
+}
 ```
 
 ## Parameters
@@ -84,39 +84,41 @@ Consider this sample document from the stores collection.
 
 ### Example 1: Basic Natural Order Sorting
 
-To retrieve stores in their natural insertion order:
+This query retrieves all stores in the order they were inserted into the collection.
 
 ```javascript
-db.stores.find({}).sort({ $natural: 1 })
+db.stores.find({}).sort({
+    $natural: 1
+})
 ```
 
-This query returns all stores in the order they were inserted into the collection.
-
 ### Example 2: Reverse Natural Order
 
-To retrieve stores in reverse insertion order (most recently inserted first):
+This query returns all stores in reverse insertion order, with the most recently added documents appearing first.
 
 ```javascript
-db.stores.find({}).sort({ $natural: -1 })
+db.stores.find({}).sort({
+    $natural: -1
+})
 ```
 
-This query returns all stores in reverse insertion order, with the most recently added documents appearing first.
-
 ### Example 3: Natural Order with Filtering
 
-To find stores with total sales above a certain threshold and sort them in natural order:
+This query filters stores with total sales greater than 50,000 and returns them in natural insertion order.
 
 ```javascript
 db.stores.find({
-  "sales.totalSales": { $gt: 50000 }
-}).sort({ $natural: 1 })
+    "sales.totalSales": {
+        $gt: 50000
+    }
+}).sort({
+    $natural: 1
+})
 ```
 
-This query filters stores with total sales greater than 50,000 and returns them in natural insertion order.
-
 ### Example 4: Natural Order with Projection
 
-To retrieve specific fields from stores in natural order:
+This query returns only the store name, total sales, and location coordinates in natural insertion order.
 
 ```javascript
 db.stores.find({}, {
@@ -127,18 +129,16 @@ db.stores.find({}, {
 }).sort({ $natural: 1 })
 ```
 
-This query returns only the store name, total sales, and location coordinates in natural insertion order.
-
 ### Example 5: Natural Order with Limit
 
-To get the first three stores that were inserted into the collection:
+This query returns the first three stores in their natural insertion order.
 
 ```javascript
-db.stores.find({}).sort({ $natural: 1 }).limit(3)
+db.stores.find({}).sort({
+    $natural: 1
+}).limit(3)
 ```
 
-This query returns the first three stores in their natural insertion order.
-
 ## Use Cases
 
 The `$natural` operator is useful in the following scenarios:
@@ -152,3 +152,4 @@ The `$natural` operator is useful in the following scenarios:
 ## Related content
 
 [!INCLUDE[Related content](../includes/related-content.md)]
+
diff --git a/articles/cosmos-db/mongodb/vcore/operators/miscellaneous-query/$rand.md b/articles/cosmos-db/mongodb/vcore/operators/miscellaneous-query/$rand.md
@@ -1,13 +1,13 @@
 ---
   title: $rand
-  titleSuffix: Overview of the $rand operation in Azure Cosmos DB for MongoDB (vCore)
+  titleSuffix: Overview of the $rand operator in Azure Cosmos DB for MongoDB (vCore)
   description: The $rand operator generates a random float value between 0 and 1.
   author: suvishodcitus
   ms.author: suvishod
   ms.service: azure-cosmos-db
   ms.subservice: mongodb-vcore
   ms.topic: language-reference
-  ms.date: 02/12/2025
+  ms.date: 09/04/2025
 ---
 
 # $rand
@@ -16,16 +16,130 @@ The `$rand` operator generates a random float value between 0 and 1. This is use
 
 ## Syntax
 
-The syntax for the `$rand` operator is as follows:
-
 ```javascript
-{ $rand: {} }
+{
+  $rand: {}
+}
 ```
 
 ## Examples
 
 Consider this sample document from the stores collection.
 
+```json
+{
+    "_id": "0fcc0bf0-ed18-4ab8-b558-9848e18058f4",
+    "name": "First Up Consultants | Beverage Shop - Satterfieldmouth",
+    "location": {
+        "lat": -89.2384,
+        "lon": -46.4012
+    },
+    "staff": {
+        "totalStaff": {
+            "fullTime": 8,
+            "partTime": 20
+        }
+    },
+    "sales": {
+        "totalSales": 75670,
+        "salesByCategory": [
+            {
+                "categoryName": "Wine Accessories",
+                "totalSales": 34440
+            },
+            {
+                "categoryName": "Bitters",
+                "totalSales": 39496
+            },
+            {
+                "categoryName": "Rum",
+                "totalSales": 1734
+            }
+        ]
+    },
+    "promotionEvents": [
+        {
+            "eventName": "Unbeatable Bargain Bash",
+            "promotionalDates": {
+                "startDate": {
+                    "Year": 2024,
+                    "Month": 6,
+                    "Day": 23
+                },
+                "endDate": {
+                    "Year": 2024,
+                    "Month": 7,
+                    "Day": 2
+                }
+            },
+            "discounts": [
+                {
+                    "categoryName": "Whiskey",
+                    "discountPercentage": 7
+                },
+                {
+                    "categoryName": "Bitters",
+                    "discountPercentage": 15
+                },
+                {
+                    "categoryName": "Brandy",
+                    "discountPercentage": 8
+                },
+                {
+                    "categoryName": "Sports Drinks",
+                    "discountPercentage": 22
+                },
+                {
+                    "categoryName": "Vodka",
+                    "discountPercentage": 19
+                }
+            ]
+        },
+        {
+            "eventName": "Steal of a Deal Days",
+            "promotionalDates": {
+                "startDate": {
+                    "Year": 2024,
+                    "Month": 9,
+                    "Day": 21
+                },
+                "endDate": {
+                    "Year": 2024,
+                    "Month": 9,
+                    "Day": 29
+                }
+            },
+            "discounts": [
+                {
+                    "categoryName": "Organic Wine",
+                    "discountPercentage": 19
+                },
+                {
+                    "categoryName": "White Wine",
+                    "discountPercentage": 20
+                },
+                {
+                    "categoryName": "Sparkling Wine",
+                    "discountPercentage": 19
+                },
+                {
+                    "categoryName": "Whiskey",
+                    "discountPercentage": 17
+                },
+                {
+                    "categoryName": "Vodka",
+                    "discountPercentage": 23
+                }
+            ]
+        }
+    ]
+}
+```
+
+### Example 1: Add a random value
+
+This query adds a random value to each store document. 
+
 ```javascript
 db.stores.aggregate([
    { 
@@ -38,9 +152,8 @@ db.stores.aggregate([
    { $limit: 2 }
 ])
 ```
-### Example 1: Add a random value
 
-This query adds a random value to each store document. When executed, it might return something like:
+The first two results returned by this query are:
 
 ```json
 [
@@ -66,3 +179,4 @@ This query adds a random value to each store document. When executed, it might r
 ## Related content
 
 [!INCLUDE[Related content](../includes/related-content.md)]
+
