Merge branch 'main' of https://github.com/MicrosoftDocs/azure-docs-pr into yelevin/unified-IIT-take-two

Author: yelevin

articles/app-service/overview-diagnostics.md

@@ -15,7 +15,7 @@ This article explains how to troubleshoot issues with your app in Azure App Serv
 
 Azure App Service diagnostics is an interactive experience to help you troubleshoot your app with no configuration required. App Service diagnostics points out what's wrong and guides you to the right information to more easily and quickly troubleshoot and resolve the problem.
 
-Although this experience is most helpful for problems that occured within the last 24 hours, all the diagnostic graphs are always available for you to analyze.
+Although this experience is most helpful for problems that occurred within the last 24 hours, all the diagnostic graphs are always available for you to analyze.
 
 App Service diagnostics works for not only apps on Windows, but also for apps on built-in or custom containers, [App Service Environments](./environment/intro.md), and [Azure Functions](../azure-functions/functions-overview.md).
 

articles/app-service/tutorial-java-jboss-mysql-app.md

@@ -665,7 +665,7 @@ If you see the error: `The subscription '701ea799-fb46-4407-bb67-9cbcf289f1c7' i
 
 Depending on your subscription and the region you select, you might see the deployment status for Azure Database for MySQL Flexible Server to be `Conflict`, with the following message in Operation details:
 
-`InternalServerError: An unexpected error occured while processing the request.`
+`InternalServerError: An unexpected error occurred while processing the request.`
 
 This error is most likely caused by a limit on your subscription for the region you select. Try choosing a different region for your deployment.
 

articles/app-service/tutorial-java-tomcat-mysql-app.md

@@ -697,7 +697,7 @@ You can ignore the warnings. The Maven Jetty plugin shows the warnings because t
 
 Depending on your subscription and the region you select, you might see the deployment status for Azure Database for MySQL Flexible Server to be `Conflict`, with the following message in Operation details:
 
-`InternalServerError: An unexpected error occured while processing the request.`
+`InternalServerError: An unexpected error occurred while processing the request.`
 
 This error is most likely caused by a limit on your subscription for the region you select. Try choosing a different region for your deployment.
 

articles/azure-functions/dotnet-aspire-integration.md

@@ -28,7 +28,7 @@ You can create a scheduler and a task hub as part of the Function app creation o
 
 Durable Task Scheduler **only** supports either *user-assigned* or *system-assigned* managed identity authentication. **User-assigned identities are recommended,** as they aren't tied to the lifecycle of the app and can be reused after the app is deprovisioned.
 
-If you haven't already, [configure managed identity for your Durable Functions app](./durable-task-scheduler-identity.md).
+See step-by-step instructions on how to [configure managed identity for your Durable Functions app](./durable-task-scheduler-identity.md).
 
 ## Access the Durable Task Scheduler dashboard
 

articles/azure-functions/durable/durable-task-scheduler/develop-with-durable-task-scheduler-functions.md

@@ -42,9 +42,9 @@ ms.date: 03/19/2025
 
 1. Click **Review + create** to review the resource creation. 
 
-   A user-assigned managed identity with the required role-based access control (RBAC) permission is created automatically so that the Function app can access durable task scheduler. You can find in the summary view information related to the managed identity resource, such as:
-   - The RBAC assigned to it (*Durable Task Data Contributor*) 
-   - The assignment scope (the scheduler or task hub name)
+   A user-assigned managed identity with the required role-based access control (RBAC) permission is created automatically and added to the Function app. You can find in the summary view information related to the managed identity resource, such as:
+   - The role assigned to it (*Durable Task Data Contributor*) 
+   - The assignment scoped to the task hub level
 
        :::image type="content" source="../media/create-durable-task-scheduler/functions-review-create-tab.png" alt-text="Screenshot of fields and properties chosen and in review on the Review + create tab.":::
 

articles/azure-functions/durable/durable-task-scheduler/includes/function-app-integrated-creation.md

@@ -57,7 +57,7 @@ In the `definitions` section of the template, specify the schemas used for valid
 
 ```json
 "definitions": {
-  "<definition-name": {
+  "<definition-name>": {
     "type": "<data-type-of-definition>",
     "allowedValues": [ "<array-of-allowed-values>" ],
     "minValue": <minimum-value-for-int>,
@@ -287,8 +287,8 @@ You define resources with the following structure:
         "<settings-for-the-resource>",
         "copy": [
             {
-                "name": ,
-                "count": ,
+                "name": "<name-of-copy-loop>",
+                "count": <number-of-iterations>,
                 "input": {}
             }
         ]

articles/azure-resource-manager/templates/syntax.md

@@ -52,7 +52,7 @@ The following example returns the deployer object.
   "outputs": {
     "developerOutput": {
       "type": "object",
-      "value": "[developer()]"
+      "value": "[deployer()]"
     }
   }
 }

articles/azure-resource-manager/templates/template-functions-deployment.md

@@ -53,14 +53,21 @@ Since these metrics give you an overview of your entire calling resource, you ca
 
 These metrics measure both the successes and failures (dcount) of the calling SDK public APIs, for example (mute, join, etc.).
 
-- reliability/api/CreateView/Local
-- reliability/api/Join
-- reliability/api/StartVideo
-- reliability/api/AcceptIncomingCall
-- reliability/api/CreateView/Remote
-- reliability/api/StopVideo
-- reliability/api/CallAgentInit
-- reliability/api/StartCall
+This table describes each property.
+
+| Property                     | Description                                                                                                                |
+|----------------------------|----------------------------------------------------------------------------------------------------------------------------|
+| `reliability/api/CreateView/Local` | Measures the reliability of the calling SDK `CreatView/Local` API which renders local video streams. This API is required for user's to see their local video stream. | 
+| `reliability/api/Join`             | Measures the reliability of the calling SDK `Join` API. When this API succeeds, a user's client is admitted to an existing call or meeting.                 |
+| `reliability/api/StartVideo` | Measures the reliability of the calling SDK `StartVideo` API which begins streaming video from the calling client to remote participants. When this API succeeds a user's client successfully sends video. |
+| `reliability/api/AcceptIncomingCall` | Measures the reliability of the calling SDK `AcceptIncomingCall` API which indicates the client successfully accepted and connected to an incoming call. |
+| `reliability/api/CreateView/Remote` | Measures the reliability of the calling SDK `CreateView/Remote` API which indicates the client successfully renders incoming video from a remote participant. |
+| `reliability/api/StopVideo` | Measures the reliability of the calling SDK `StopVideo` API which indicates the calling SDK successfully stopped streaming video to remote participants. |
+| `reliability/api/CallAgentInit` | Measures the reliability of the calling SDK `CallAgentInit` API which indicates the calling SDK successfully created the `CallAgent` object. If this fails, the reliability/api/Join or reliability/api/StartCall APIs can not be triggered. |
+| `reliability/api/StartCall` | Measures the reliability of the calling SDK `StartCall` API which indicates the calling SDK succseffuly initiated a new call.  | 
+| `reliability/api/Drop` | Measures the reliability of individual call legs by identifying which call legs were dropped unexpectedly after they successfully connected to a call. Focuses on participants call legs that successfully connected to a call and checks if the call legs were later dropped due to specific error codes.  |
+
+
 
 ### User Facing Diagnostics (UFD) metrics
 

articles/communication-services/concepts/analytics/logs/call-metrics-log-schema.md

@@ -1,20 +1,20 @@
 ---
 title: Voice and video concepts in Azure Communication Services
-titleSuffix: An Azure Communication Services concept document
+titleSuffix: An Azure Communication Services article
 description: Learn about Communication Services call types.
 author: sloanster
 manager: chpalm
 services: azure-communication-services
 
 ms.author: micahvivion
-ms.date: 03/11/2023
+ms.date: 05/01/2025
 ms.topic: conceptual
 ms.service: azure-communication-services
 ms.subservice: calling
 ---
 # Voice and video concepts
 
-You can use Azure Communication Services to make and receive one to one or group voice and video calls. Your calls can be made to other Internet-connected devices and to plain-old telephones. You can use the Communication Services JavaScript, Android, or iOS SDKs to build applications that allow your users to speak to one another in private conversations or in group discussions. Azure Communication Services supports calls to and from services or Bots.
+You can use Azure Communication Services to make and receive one to one or group voice and video calls. You can make calls to other Internet-connected devices and to plain-old telephones. You can use the Communication Services JavaScript, Android, or iOS SDKs to build applications that enable your users to speak to one another in private conversations or in group discussions. Azure Communication Services supports calls to and from services or bots.
 
 ## Call types in Azure Communication Services
 
@@ -26,7 +26,7 @@ When a user of your application calls another user of your application over an i
 
 ### Public switched telephone network (PSTN)
 
-Anytime your users interact with a traditional telephone number, calls are facilitated by PSTN (Public Switched Telephone Network) voice calling. To make and receive PSTN calls, you need to add telephony capabilities to your Azure Communication Services resource. In this case, signaling and media use a combination of IP-based and PSTN-based technologies to connect your users.
+Any time your users interact with a traditional telephone number, the Public Switched Telephone Network (PSTN) voice calling facilitates the calls. To make and receive PSTN calls, you need to add telephony capabilities to your Azure Communication Services resource. In this case, signaling and media use a combination of IP-based and PSTN-based technologies to connect your users.
 
 ### One-to-one call
 
@@ -38,17 +38,18 @@ A group call on Azure Communication Services happens when three or more particip
 
 ### Rooms call
 
-A call that takes place within the context of a Room. A Room is a container that manages activity between Azure Communication Services end-users. A Room offers application developers better control over *who* can join a call, *when* they meet and *how* they collaborate. To learn more about Rooms, see the [conceptual documentation](../rooms/room-concept.md). 
+A call that takes place within the context of a Room. A Room is a container that manages activity between Azure Communication Services end-users. A Room offers application developers better control over *who* can join a call, *when* they meet and *how* they collaborate. For more information, see the [rooms conceptual documentation](../rooms/room-concept.md). 
 
 ### Supported video standards
 We support H.264 (MPEG-4) video codec.
 
 ### Video quality
+
 | Maximum video resolution | WebJS | iOS | Android | Windows |
 | ------------- | ----- | ----- | ------- | ------- |
-| **Receiving a remote video stream or screen share** | 1080P | 1080P | 1080P   | 1080P   | 
-| **Sending video**    | 720P  | 720P  | 720P    | 1080P   |
-| **Sending screen share**    | 1080P  | 1080P  | 1080P    | 1080P   |
+| **Receiving a remote video stream or screen share** | 1080-P | 1080-P | 1080-P   | 1080-P   | 
+| **Sending video**    | 720-P  | 720-P  | 720-P    | 1080-P   |
+| **Sending screen share**    | 1080-P  | 1080-P  | 1080-P    | 1080-P   |
 
 The resolution can vary depending on the number of participants on a call, the amount of bandwidth available to the client, hardware capabilities of local participant who renders remote video streams and other overall call parameters.
 
@@ -57,7 +58,8 @@ The resolution can vary depending on the number of participants on a call, the a
 > [!div class="nextstepaction"]
 > [Get started with calling](../../quickstarts/voice-video-calling/getting-started-with-calling.md)
 
-For more information, see the following articles:
-- Familiarize yourself with general [call flows](../call-flows.md)
-- [Phone number types](../telephony/plan-solution.md)
-- Learn about the [Calling SDK capabilities](../voice-video-calling/calling-sdk-features.md)
+## Related articles
+
+- Familiarize yourself with general [call flows](../call-flows.md).
+- Learn about [Phone number types](../telephony/plan-solution.md).
+- Learn about the [Calling SDK capabilities](../voice-video-calling/calling-sdk-features.md).