Merge branch 'MicrosoftDocs:main' into cosmos-nosql-query-geospatial

Author: seesharprun

articles/communication-services/quickstarts/telephony/get-trial-phone-number.md

@@ -14,7 +14,7 @@ ms.custom: template-quickstart
 [!INCLUDE [Public Preview Notice](../../includes/public-preview-include.md)]
 
 > [!NOTE]
-> Trial Phone Numbers are currently only supported by Azure subscriptions with billing addresses based in the United States. To those outside the US, you can visit the [Subscription eligibility](../../concepts/numbers/sub-eligibility-number-capability.md) documentation to determine where you purchase a phone number. 
+> Trial Phone Numbers are currently only supported by Azure subscriptions with billing addresses based in the United States. For other geographies, please visit the [Subscription eligibility](../../concepts/numbers/sub-eligibility-number-capability.md) documentation to determine where you can purchase a phone number. 
 
 Azure Communication Services provides powerful communication capabilities for developers to integrate voice, video, and SMS functionalities into their applications. One of the key features is the ability to acquire phone numbers for making and receiving calls. This quickstart guide walks you through the process of obtaining a trial phone number for Azure Communication Services. 
 
@@ -34,30 +34,30 @@ If you don’t have any phone numbers yet, you will see an empty list of phone n
 If you already have numbers for your Communication Services resource, you can also activate a trial phone number: 
 :::image type="content" source="./media/trial-phone-numbers/trial-empty-with-purchased-numbers.png" alt-text="Screenshot showing a Communication Services resource's phone numbers page with already purchased numbers." lightbox="./media/trial-phone-numbers/trial-empty-with-purchased-numbers.png":::
 
-3. Select on “Activate trial phone number”. This immediately provisions a trial phone number to your Communication Services resource.  Once the trial phone number is provisioned, you can view it on the Phone numbers page. 
+3. Select on “Activate trial phone number”. This immediately provisions a trial phone number to your Communication Services resource. Once the trial phone number is provisioned, you can view it on the Phone numbers page. 
 :::image type="content" source="./media/trial-phone-numbers/trial-activated.png" alt-text="Screenshot showing a Communication Services resource's phone numbers page with a trial phone number." lightbox="./media/trial-phone-numbers/trial-activated.png":::
 
 ## Add a verified phone number to your trial phone number
-When using a trial phone number in Azure Communication Services for PSTN Calling capabilities, it is required to verify the recipient phone number. This verification process ensures that the trial phone number can only make calls to the verified number. 
+When using a trial phone number in Azure Communication Services for PSTN Calling capabilities, it is mandatory to verify the recipient phone number. This verification process ensures that the trial phone number can only make calls to the verified number. 
 
-1. Once your trial phone number is provisioned, select on the number in the Phone Numbers page and navigate to the “Trial details” tab: 
+1. Once your trial phone number is provisioned, select the number in the Phone Numbers page and navigate to the “Trial details” tab: 
 :::image type="content" source="./media/trial-phone-numbers/trial-details.png" alt-text="Screenshot showing a Communication Services resource's phone numbers page with a side panel open with the trial details tab." lightbox="./media/trial-phone-numbers/trial-details.png":::
 This tab shows the current limitations on the number, including the days left to use the number, the total calling minutes, and how many verified phone numbers are attached to the trial phone number. You can find more information on the trial phone number limitations [here](../../concepts/telephony/trial-phone-numbers-faq.md).
 
 2. Select on “Manage verified phone numbers” to start adding verified phone numbers. 
 :::image type="content" source="./media/trial-phone-numbers/verified-empty.png" alt-text="Screenshot showing a side panel with an empty list of verified phone numbers." lightbox="./media/trial-phone-numbers/verified-empty.png":::
 
-3. Select “Add” or “Verify a phone number” and enter your phone number and designated country code associated with it. This recipient phone number is verified by sending a one-time passcode (OTP) to their number either through SMS or automated voicemail. Choose which option you prefer, and then press “Next” to receive the OTP. 
+3. Select “Add” or “Verify a phone number” and enter your phone number and designated country code associated with it. This recipient phone number is verified by sending a one-time passcode (OTP) to their number either through SMS or automated voicemail. Choose the option you prefer, and then press “Next” to receive the OTP. 
 :::image type="content" source="./media/trial-phone-numbers/verified-enter-number.png" alt-text="Screenshot showing a side panel with an entered phone number to verify. The radio button to text the phone number has been selected." lightbox="./media/trial-phone-numbers/verified-enter-number.png":::
 
 4. Once the user gets the one-time-passcode (OTP), enter the code into the Portal to verify the number.  
 :::image type="content" source="./media/trial-phone-numbers/verified-text-code.png" alt-text="Screenshot showing a side panel with an entered one-time passcode." lightbox="./media/trial-phone-numbers/verified-text-code.png":::
 
-5. Once the correct OTP is entered, the phone number is verified, and it shows in the list of verified numbers that the trial number can call. 
+5. Once the correct OTP is entered, the phone number is verified, it should show up in the list of verified numbers that the trial number can call. 
 :::image type="content" source="./media/trial-phone-numbers/verified-added.png" alt-text="Screenshot showing a side panel with an added verified phone number." lightbox="./media/trial-phone-numbers/verified-added.png"::: 
 
 ## Conclusion
-Congratulations! You have successfully obtained a trial phone number for Azure Communication Services. You can now use this phone number to add voice capabilities to your applications. Explore the documentation and resources provided by Microsoft to learn more about Azure Communication Services and integrate it into your projects. 
+Congratulations! You have successfully obtained a trial phone number for Azure Communication Services. You can now use this phone number to add voice capabilities to your applications. Explore the documentation and resources provided by Microsoft to learn more about Azure Communication Services and integrate it into your solutions. 
 
 Remember that trial phone numbers have limitations and are intended for evaluation and development purposes. If you require production-ready phone numbers, you can upgrade your Azure Communication Services subscription and [purchase a phone number](get-phone-number.md). 
 

articles/cosmos-db/nosql/query/object-array.md

@@ -1,207 +1,147 @@
 ---
-title: Working with arrays and objects in Azure Cosmos DB
-description: Learn the SQL syntax to create arrays and objects in Azure Cosmos DB. This article also provides some examples to perform operations on array objects 
-author: seesharprun
+title: Working with arrays and objects
+titleSuffix: Azure Cosmos DB for NoSQL
+description: Create arrays and objects and perform actions on them using the array syntax in Azure Cosmos DB for NoSQL.
+author: jcodella
+ms.author: jacodel
+ms.reviewer: sidandrews
 ms.service: cosmos-db
 ms.subservice: nosql
-ms.custom: ignite-2022
-ms.topic: conceptual
-ms.date: 02/02/2021
-ms.author: sidandrews
-ms.reviewer: jucocchi
+ms.topic: reference
+ms.date: 07/31/2023
+ms.custom: query-reference
 ---
-# Working with arrays and objects in Azure Cosmos DB
-[!INCLUDE[NoSQL](../../includes/appliesto-nosql.md)]
 
-A key feature of the Azure Cosmos DB for NoSQL is array and object creation. This document uses examples that can be recreated using the [Family dataset](getting-started.md#upload-sample-data).
+# Working with arrays and objects in Azure Cosmos DB for NoSQL
+
+[!INCLUDE[NoSQL](../../includes/appliesto-nosql.md)]
 
-Here's an example item in this dataset:
+Here's an item that's used in examples throughout this article.
 
 ```json
 {
-  "id": "AndersenFamily",
-  "lastName": "Andersen",
-  "parents": [
-     { "firstName": "Thomas" },
-     { "firstName": "Mary Kay"}
+  "name": "Sondon Fins",
+  "categories": [
+     { "name": "swim" },
+     { "name": "gear"}
   ],
-  "children": [
-     {
-         "firstName": "Henriette Thaulow",
-         "gender": "female",
-         "grade": 5,
-         "pets": [{ "givenName": "Fluffy" }]
-     }
-  ],
-  "address": { "state": "WA", "county": "King", "city": "Seattle" },
-  "creationDate": 1431620472,
-  "isRegistered": true
+  "metadata": {
+    "sku": "73310",
+    "manufacturer": "AdventureWorks"
+  },
+  "priceInUSD": 132.35,
+  "priceInCAD": 174.50
 }
 ```
 
 ## Arrays
 
-You can construct arrays, as shown in the following example:
+You can construct arrays using static values, as shown in the following example.
 
 ```sql
-SELECT [f.address.city, f.address.state] AS CityState
-FROM Families f
+SELECT
+  [p.priceInUSD, p.priceInCAD] AS priceData
+FROM products p
 ```
 
-The results are:
-
 ```json
 [
   {
-    "CityState": [
-      "Seattle",
-      "WA"
-    ]
-  },
-  {
-    "CityState": [
-      "NY", 
-      "NY"
+    "priceData": [
+      132.35,
+      174.5
     ]
   }
 ]
 ```
 
-You can also use the [ARRAY expression](subquery.md#array-expression) to construct an array from [subquery's](subquery.md) results. This query gets all the distinct given names of children in an array.
+You can also use the [``ARRAY`` expression](subquery.md#array-expression) to construct an array from a [subquery's](subquery.md) results. This query gets all the distinct categories.
 
 ```sql
-SELECT f.id, ARRAY(SELECT DISTINCT VALUE c.givenName FROM c IN f.children) as ChildNames
-FROM f
+SELECT
+    p.id,
+    ARRAY (SELECT DISTINCT VALUE c.name FROM c IN p.categories) AS categoryNames
+FROM
+    products p
 ```
 
-The results are:
-
 ```json
 [
-    {
-        "id": "AndersenFamily",
-        "ChildNames": []
-    },
-    {
-        "id": "WakefieldFamily",
-        "ChildNames": [
-            "Jesse",
-            "Lisa"
-        ]
-    }
+  {
+    "id": "a0151c77-ffc3-4fa6-a495-7b53d936faa6",
+    "categoryNames": [
+      "swim",
+      "gear"
+    ]
+  }
 ]
 ```
 
-## <a id="Iteration"></a>Iteration
-
-The API for NoSQL provides support for iterating over JSON arrays, with the [IN keyword](keywords.md#in) in the FROM source. In the following example:
-
-```sql
-SELECT *
-FROM Families.children
-```
-
-The results are:
+## Iteration
 
-```json
-[
-  [
-    {
-      "firstName": "Henriette Thaulow",
-      "gender": "female",
-      "grade": 5,
-      "pets": [{ "givenName": "Fluffy"}]
-    }
-  ], 
-  [
-    {
-      "familyName": "Merriam",
-      "givenName": "Jesse",
-      "gender": "female",
-      "grade": 1
-    }, 
-    {
-      "familyName": "Miller",
-      "givenName": "Lisa",
-      "gender": "female",
-      "grade": 8
-    }
-  ]
-]
-```
+The API for NoSQL provides support for iterating over JSON arrays, with the [``IN`` keyword](keywords.md#in) in the ``FROM`` source. 
 
-The next query performs iteration over `children` in the `Families` container. The output array is different from the preceding query. This example splits `children`, and flattens the results into a single array:  
+As an example, the next query performs iteration over ``tags`` for each item in the container. The output splits the array value and flattens the results into a single array.
 
 ```sql
-SELECT *
-FROM c IN Families.children
+SELECT
+    *
+FROM 
+  products IN products.categories
 ```
 
-The results are:
-
 ```json
 [
   {
-      "firstName": "Henriette Thaulow",
-      "gender": "female",
-      "grade": 5,
-      "pets": [{ "givenName": "Fluffy" }]
-  },
-  {
-      "familyName": "Merriam",
-      "givenName": "Jesse",
-      "gender": "female",
-      "grade": 1
+    "name": "swim"
   },
   {
-      "familyName": "Miller",
-      "givenName": "Lisa",
-      "gender": "female",
-      "grade": 8
+    "name": "gear"
   }
 ]
 ```
 
 You can filter further on each individual entry of the array, as shown in the following example:
 
 ```sql
-SELECT c.givenName
-FROM c IN Families.children
-WHERE c.grade = 8
+SELECT VALUE
+    p.name
+FROM
+    p IN p.categories
+WHERE
+    p.name LIKE "ge%"
 ```
 
 The results are:
 
 ```json
-[{
-  "givenName": "Lisa"
-}]
+[
+  "gear"
+]
 ```
 
-You can also aggregate over the result of an array iteration. For example, the following query counts the number of children among all families:
+You can also aggregate over the result of an array iteration. For example, the following query counts the number of tags:
 
 ```sql
-SELECT COUNT(1) AS Count
-FROM child IN Families.children
+SELECT VALUE
+    COUNT(1)
+FROM
+    p IN p.categories
 ```
 
 The results are:
 
 ```json
 [
-  {
-    "Count": 3
-  }
+  2
 ]
 ```
 
 > [!NOTE]
-> When using the IN keyword for iteration, you cannot filter or project any properties outside of the array. Instead, you should use [JOINs](join.md).
-
-For additional examples, read our [blog post on working with arrays in Azure Cosmos DB](https://devblogs.microsoft.com/cosmosdb/understanding-how-to-query-arrays-in-azure-cosmos-db/).
+> When using the ``IN`` keyword for iteration, you cannot filter or project any properties outside of the array. Instead, you should use [self-joins](join.md).
 
 ## Next steps
 
-- [Getting started](getting-started.md)
-- [Azure Cosmos DB .NET samples](https://github.com/Azure/azure-cosmos-dotnet-v3)
-- [Joins](join.md)
+- [Self-joins](join.md)
+- [Keywords](keywords.md)
+- [Subqueries](subquery.md)