Merge branch 'main' of https://github.com/MicrosoftDocs/azure-docs-pr into HOBO

Author: MekaylaMoore

articles/baremetal-infrastructure/workloads/nc2-on-azure/get-started.md

@@ -11,9 +11,9 @@ ms.service: azure-baremetal-infrastructure
 # Customer intent: As an IT administrator, I want to sign up for and configure Nutanix Cloud Clusters on Azure, so that I can efficiently manage my cloud infrastructure while ensuring connectivity and compliance with my organization’s requirements.
 ---
 
-# Getting started with Nutanix Cloud Clusters on Azure
+# Get started with Nutanix Cloud Clusters on Azure
 
-Learn how to sign up for, set up, and use Nutanix Cloud Clusters (NC2) on Azure.
+Learn how to sign up for, set up, and use Nutanix Cloud Clusters (NC2) on Azure. You can also sign up for a free trial of NC2 on Azure.
 
 ## Azure account requirements
 
@@ -25,6 +25,22 @@ Learn how to sign up for, set up, and use Nutanix Cloud Clusters (NC2) on Azure.
 For more information, see "NC2 on Azure Subscription and Billing" in [Nutanix Cloud Clusters on Azure Deployment and User Guide]
 (https://portal.nutanix.com/page/documents/details?targetId=Nutanix-Cloud-Clusters-Azure:Nutanix-Cloud-Clusters-Azure).
 
+## Start with a free trial of NC2 on Azure
+
+To help you evaluate NC2 on Azure, Nutanix offers and manages a 30-day free trial. You can sign up for the trial with Nutanix. 
+
+Consider these important items for Nutanix on Azure BareMetal nodes:
+
+**Cost coverage**: The BareMetal cluster nodes have no cost through the trial. Other components like VMs for Flow Gateway networking and other Azure services are billed and not included in the trial.
+
+**Trial duration**: The trial begins with the initial hardware node deployment and lasts for 30 consecutive days. It can't be paused, and the start date is fixed regardless of cluster activity. Even if the cluster is dropped, the trial time continues.
+
+**One-time opportunity**: The trial is a one-time offer. If you deploy a cluster after the initial 30-day trial period, regardless of the timeframe, the trial doesn't reset, and you'll be billed. Creating a cluster in a different subscription does not reset your trial timing.
+
+**Track the trial period**: There's no visible trial information for the BareMetal. You should track your BareMetal deployment date manually.
+
+For more information, see _*[Starting a Free Trial for NC2 ](https://portal.nutanix.com/page/documents/details?targetId=Nutanix-Cloud-Clusters-Azure:nc2-clusters-starting-a-nc2-free-trial-t.html"https://portal.nutanix.com/page/documents/details?targetid=nutanix-cloud-clusters-azure:nc2-clusters-starting-a-nc2-free-trial-t.html")*
+
 ## Networking requirements
 
 * Connectivity between your on-premises datacenter and Azure. Both ExpressRoute and VPN are supported. 
@@ -41,7 +57,7 @@ gateway-external-api.cloud.nutanix.com.
 
 ## Sign up for NC2
 
-Go to [Nutanix Cloud Clusters on Azure Deployment and User Guide](https://portal.nutanix.com/page/documents/details?targetId=Nutanix-Cloud-Clusters-Azure:Nutanix-Cloud-Clusters-Azure) to sign up.
+To sign up, go to [Nutanix Cloud Clusters on Azure Deployment and User Guide(https://portal.nutanix.com/page/documents/details?targetId=Nutanix-Cloud-Clusters-Azure:Nutanix-Cloud-Clusters-Azure).
 
 To learn about Microsoft BareMetal hardware pricing, and to purchase Nutanix software, go to [Azure Marketplace](https://azuremarketplace.microsoft.com/marketplace/apps/nutanixinc.nc2_azure?tab=Overview).
 

articles/communication-services/how-tos/call-automation/actions-for-call-control.md

@@ -1,7 +1,7 @@
 ---
-title: Azure Communication Services Call Automation how-to for passing call contextual data in Call Automation 
+title: Azure Communication Services Call Automation How-to for Passing Call Contextual Data in Call Automation 
 titleSuffix: An Azure Communication Services how-to document
-description: Provides a how-to guide for passing contextual information with Call Automation.
+description: The article shows how to pass contextual information with Call Automation.
 author: jutik0
 ms.topic: how-to
 ms.service: azure-communication-services
@@ -12,38 +12,39 @@ manager: visho
 services: azure-communication-services
 ---
 
-# How to pass contextual data between calls
+# Pass contextual data between calls
 
-Call Automation allows developers to pass along custom contextual information when routing calls. Developers can pass metadata about the call, callee or any other information that is relevant to their application or business logic. This allows businesses to manage, and route calls across networks without having to worry about losing context.
+Call Automation allows developers to pass along custom contextual information when routing calls. Developers can pass metadata about the call, caller, or any other information that's relevant to their application or business logic. Businesses can then manage and route calls across networks without having to worry about losing context.
 
-Passing context is supported by specifying custom headers. These are an optional list of key-value pairs that can be included as part of `AddParticipant` or `Transfer` actions. The context can be later retrieved as part of the `IncomingCall` event payload.
+Passing context is supported by specifying custom headers. This optional list of key/value pairs is included as part of `AddParticipant` or `Transfer` actions. The context is retrieved later as part of the `IncomingCall` event payload.
 
-Custom call context is also forwarded to the SIP protocol, this includes both the freeform custom headers as well as the standard User-to-User Information (UUI) SIP header. When routing an inbound call from your telephony network, the data set from your SBC in the custom headers and UUI is similarly included in the `IncomingCall` event payload. 
+Custom call context is also forwarded to the Session Initiation Protocol (SIP), which includes both the freeform custom headers and the standard user-to-user information (UUI) SIP header. When an inbound call from your telephony network is routed, the data set from your Session Border Controller (SBC) in the custom headers and UUI is similarly included in the `IncomingCall` event payload.
 
-All custom context data is opaque to Call Automation or SIP protocols and its content is unrelated to any basic functions.
+All custom context data is opaque to Call Automation or SIP protocols, and its content is unrelated to any basic functions.
 
-Below are samples on how to get started using custom context headers in Call Automation. 
+The following samples show how to get started by using custom context headers in Call Automation.
 
-As a prerequisite, we recommend you to read these articles to make the most of this guide:
+## Prerequisites
 
-- Call Automation [concepts guide](../../concepts/call-automation/call-automation.md#call-actions) that describes the action-event programming model and event callbacks.
-- Learn about [user identifiers](../../concepts/identifiers.md#the-communicationidentifier-type) like CommunicationUserIdentifier and PhoneNumberIdentifier used in this guide.
+- Read the Call Automation [concepts article](../../concepts/call-automation/call-automation.md#call-actions) that describes the action-event programming model and event callbacks.
+- Learn about the [user identifiers](../../concepts/identifiers.md#the-communicationidentifier-type) like `CommunicationUserIdentifier` and PhoneNumberIdentifier` that are used in this article.
 
-For all the code samples, `client` is CallAutomationClient object that can be created as shown and `callConnection` is the CallConnection object obtained from Answer or CreateCall response. You can also obtain it from callback events received by your application.
+For all the code samples, `client` is the `CallAutomationClient` object that you can create, and `callConnection` is the `CallConnection` object that you obtain from an `Answer` or `CreateCall` response. You can also obtain it from callback events that your application receives.
 
 ## Technical parameters
-Call Automation supports up to 5 custom SIP headers and 1000 custom VOIP headers. Additionally, developers can include a dedicated User-To-User header as part of SIP headers list.
 
-The custom SIP header key must start with a mandatory ‘X-MS-Custom-’ prefix.  The maximum length of a SIP header key is 64 chars, including the X-MS-Custom prefix. The SIP header key may consist of alphanumeric characters and a few selected symbols which includes `.`, `!`, `%`, `*`, `_`, `+`, `~`, `-`. The maximum length of SIP header value is 256 chars. The same limitations apply when configuring the SIP headers on your SBC. The SIP header value may consist of alphanumeric characters and a few selected symbols which includes `=`, `;`, `.`, `!`, `%`, `*`, `_`, `+`, `~`, `-`.
+Call Automation supports up to five custom SIP headers and 1,000 custom voice-over-IP (VoIP) headers. Developers can include a dedicated user-to-user header as part of a SIP headers list.
 
-The maximum length of a VOIP header key is 64 chars. These headers can be sent without ‘x-MS-Custom’ prefix. The maximum length of VOIP header value is 1024 chars.
+The custom SIP header key must start with a mandatory `X-MS-Custom-` prefix. The maximum length of a SIP header key is 64 characters, including the `X-MS-Custom` prefix. The SIP header key consists of alphanumeric characters and a few selected symbols, which include `.`, `!`, `%`, `*`, `_`, `+`, `~`, and `-`. The maximum length of a SIP header value is 256 characters. The same limitations apply when you configure the SIP headers on your SBC. The SIP header value consists of alphanumeric characters and a few selected symbols, which include `=`, `;`, `.`, `!`, `%`, `*`, `_`, `+`, `~`, and `-`.
 
-## Adding custom context when inviting a participant
+The maximum length of a VoIP header key is 64 characters. These headers can be sent without the `x-MS-Custom` prefix. The maximum length of a VoIP header value is 1,024 characters.
 
-### [csharp](#tab/csharp)
+## Add custom context when you invite a participant
+
+### [C#](#tab/csharp)
 
 ```csharp
-// Invite a communication services user and include one VOIP header
+// Invite an Azure Communication Services user and include one VOIP header
 var addThisPerson = new CallInvite(new CommunicationUserIdentifier("<user_id>"));
 addThisPerson.CustomCallingContext.AddVoip("myHeader", "myValue");
 AddParticipantsResult result = await callConnection.AddParticipantAsync(addThisPerson);
@@ -60,7 +61,7 @@ AddParticipantsResult result = await callConnection.AddParticipantAsync(addThisP
 ```
 ### [Java](#tab/java)
 ```java
-// Invite a communication services user and include one VOIP header
+// Invite an Azure Communication Services user and include one VOIP header
 CallInvite callInvite = new CallInvite(new CommunicationUserIdentifier("<user_id>"));
 callInvite.getCustomCallingContext().addVoip("voipHeaderName", "voipHeaderValue");
 AddParticipantOptions addParticipantOptions = new AddParticipantOptions(callInvite);
@@ -77,7 +78,7 @@ Response<AddParticipantResult> addParticipantResultResponse = callConnectionAsyn
 
 ### [JavaScript](#tab/javascript)
 ```javascript
-// Invite a communication services user and include one VOIP header
+// Invite an Azure Communication Services user and include one VOIP header
 const customCallingContext: CustomCallingContext = [];
 customCallingContext.push({ kind: "voip", key: "voipHeaderName", value: "voipHeaderValue" })
 const addThisPerson = {
@@ -101,7 +102,7 @@ const addParticipantResult = await callConnection.addParticipant(addThisPerson);
 
 ### [Python](#tab/python)
 ```python
-#Invite a communication services user and include one VOIP header
+#Invite an Azure Communication Services user and include one VOIP header
 voip_headers = {"voipHeaderName", "voipHeaderValue"}
 target = CommunicationUserIdentifier("<acs_user_id>")
 result = call_connection_client.add_participant(
@@ -123,12 +124,12 @@ result = call_connection_client.add_participant(
 ```
 
 -----
-## Adding custom context during call transfer
+## Add a custom context during a call transfer
 
-### [csharp](#tab/csharp)
+### [C#](#tab/csharp)
 
 ```csharp
-//Transfer to communication services user and include one VOIP header
+//Transfer to an Azure Communication Services user and include one VOIP header
 var transferDestination = new CommunicationUserIdentifier("<user_id>"); 
 var transferOption = new TransferToParticipantOptions(transferDestination);   
 var transferOption = new TransferToParticipantOptions(transferDestination) {
@@ -148,7 +149,7 @@ TransferCallToParticipantResult result = await callConnection.TransferCallToPart
 
 ### [Java](#tab/java)
 ```java
-//Transfer to communication services user and include one VOIP header
+//Transfer to an Azure Communication Services user and include one VOIP header
 CommunicationIdentifier transferDestination = new CommunicationUserIdentifier("<user_id>");
 TransferCallToParticipantOptions options = new TransferCallToParticipantOptions(transferDestination);
 options.getCustomCallingContext().addVoip("voipHeaderName", "voipHeaderValue");
@@ -164,7 +165,7 @@ Response<TransferCallResult> transferResponse = callConnectionAsync.transferToPa
 
 ### [JavaScript](#tab/javascript)
 ```javascript
-//Transfer to communication services user and include one VOIP header
+//Transfer to an Azure Communication Services user and include one VOIP header
 const transferDestination = { communicationUserId: "<user_id>" };
 const transferee = { communicationUserId: "<transferee_user_id>" };
 const options = { transferee: transferee, operationContext: "<Your_context>", operationCallbackUrl: "<url_endpoint>" };
@@ -186,7 +187,7 @@ const result = await callConnection.transferCallToParticipant(transferDestinatio
 
 ### [Python](#tab/python)
 ```python
-#Transfer to communication services user and include one VOIP header
+#Transfer to an Azure Communication Services user and include one VOIP header
 transfer_destination = CommunicationUserIdentifier("<user_id>")
 transferee = CommunicationUserIdentifier("transferee_user_id")
 voip_headers = {"customVoipHeader1", "customVoipHeaderValue1"}
@@ -213,12 +214,12 @@ result = call_connection_client.transfer_call_to_participant(
 )
 ```
 
-Transfer of a VoIP call to a phone number is currently not supported.
+Currently, transfer of a VoIP call to a phone number isn't supported.
 
 -----
-## Reading custom context from an incoming call event
+## Read custom context from an incoming call event
 
-### [csharp](#tab/csharp)
+### [C#](#tab/csharp)
 
 ```csharp
 AcsIncomingCallEventData incomingEvent = <incoming call event from Event Grid>;
@@ -282,8 +283,7 @@ userToUser = sipHeaders["user-To-User"]
 ```
 
 -----
-## Additional resources
-
-- For a sample payload of the incoming call, refer to this [guide](../../../event-grid/communication-services-voice-video-events.md#microsoftcommunicationincomingcall).
+## Related content
 
+- For a sample payload of the incoming call, see [Azure Communication Services: Voice and video calling events](../../../event-grid/communication-services-voice-video-events.md#microsoftcommunicationincomingcall).
 - Learn more about [SIP protocol details for direct routing](../../concepts/telephony/direct-routing-sip-specification.md).