Merge pull request #298454 from vac0224/vc-urgent-toc-2025-04-18

JillGrant615 · web-flow · commit af6ae42482b2 · 2025-04-17T20:17:55.000-06:00
Fix missing SMS articles
diff --git a/articles/communication-services/concepts/sms/ten-digit-long-code-guidelines.md b/articles/communication-services/concepts/sms/ten-digit-long-code-guidelines.md
@@ -1,6 +1,6 @@
 ---
 title: Ten digit long code (10DLC) registration guidelines
-titleSuffix: An Azure Communication Services concept document
+titleSuffix: An Azure Communication Services article
 description: This article describes how to prepare for 10 digit long code (10DLC) brand registration and campaign registration.
 author: prakulka
 manager: darmour
@@ -16,7 +16,7 @@ ms.custom: references_regions
 
 # Ten digit long code (10DLC) registration guidelines
 
-To send Application-to-Person (A2P) SMS messages using 10 digit long codes (10DLC), businesses must complete **brand registration** and **campaign registration**. This ensures compliance with carrier and CTIA guidelines while enabling high-quality message delivery.
+To send Application-to-Person (A2P) SMS messages using 10 digit long codes (10DLC), businesses must complete **brand registration** and **campaign registration**. Registering ensures compliance with carrier and Cellular Telecommunications Industry Association (CTIA) guidelines while enabling high-quality message delivery.
 
 This article describes how to complete the required fields for **brand registration** and **campaign registration**.
 
@@ -44,7 +44,7 @@ Brand registration typically takes 2 to 3 business days with TCR (The Campaign R
 | **Brand Name**     | Official name of your organization. | Contoso Inc. |
 | **EIN / Tax ID**   | Employer Identification Number or Tax ID (required for non-Sole Proprietor entities). | 12-3456789 |
 | **Business Type**  | Select the appropriate business type (Sole Proprietor, LLC, Corporation, and so on). | Corporation |
-| **Website**        | Website URL associated with your business (used for verification). | https://www.contoso.com |
+| **Website**        | Website URL associated with your business (used for verification). | `https://www.contoso.com` |
 | **Vertical**       | Industry in which your business operates. | E-commerce |
 | **Email Address**  | Contact email for registration-related updates. | contact@contoso.com |
 
@@ -56,7 +56,7 @@ Brand registration typically takes 2 to 3 business days with TCR (The Campaign R
 
 ## Campaign registration
 
-Campaign registration enables you to specify the purpose of your messaging (such as marketing, customer service, or two-factor authentication) and how you plan to use 10DLC numbers. This step ensures that your use case complies with regulations and that carriers can properly route and filter messages based on the campaign type.
+Campaign registration enables you to specify the purpose of your messaging (such as marketing, customer service, or two-factor authentication) and how you plan to use 10DLC numbers. This step ensures that your use case complies with regulations so carriers can properly route and filter messages based on the campaign type.
 
 Campaign details must accurately reflect the content and intent of your messages. Providing false or misleading information could lead to rejections or delays in the approval of your campaign.
 
@@ -72,10 +72,10 @@ Campaign registration with TCR typically takes 3 to 5 business days for approval
 | **Campaign Name**        | Name identifying your campaign. | Contoso Marketing Campaign |
 | **Campaign Description** | A detailed description of the campaign’s purpose.  | Send promotional offers and updates to customers who opt in to Contoso's SMS notifications. |
 | **Use Case**             | The primary purpose of the campaign (such as marketing or customer care). | Marketing |
-| **Message Samples**      | Provide examples of the messages your campaign will send. | “Hello! Thank you for subscribing to Contoso updates. Reply STOP to opt out.” |
-| **Subscriber Opt-in**     | Confirms that recipients have explicitly consented to receive messages. | “Thank you for subscribing to Contoso Alerts. Reply HELP for help, STOP to unsubscribe.” |
+| **Message Samples**      | Provide examples of the messages your campaign plans to send. | “Hello! Thank you for subscribing to Contoso updates. Reply STOP to opt out.” |
+| **Subscriber Opt-in**     | Confirms that recipients explicitly consent to receive messages. | “Thank you for subscribing to Contoso Alerts. Reply HELP for help, STOP to unsubscribe.” |
 | **Subscriber Opt-out**    | Allows recipients to stop receiving messages at any time. | “You have unsubscribed from Contoso Alerts. Reply START to resubscribe.” |
-| **Subscriber Help**       | Provides instructions or assistance to users. | “For assistance, visit [www.contoso.com](https://www.contoso.com) or call 1-800-CONTOSO.” |
+| **Subscriber Help**       | Provides instructions or assistance to users. | “For assistance, visit `https://www.contoso.com` or call 1-800-CONTOSO.” |
 | **Embedded Links**        | Indicates if messages include URLs. | Yes |
 | **Embedded Phone Numbers**| Indicates if messages include phone numbers. | Yes |
 | **Age-gated Content**     | Indicates if messages are age-restricted. | No |
@@ -84,7 +84,7 @@ Campaign registration with TCR typically takes 3 to 5 business days for approval
 
 1. When is brand vetting required?
 
-Brand vetting for 10DLC messaging is typically required for companies outside the Russell 3000 list as these companies are considered as pre-vetted. Smaller businesses, companies without EIN, unverified brands may require brand vetting.
+Brand vetting for 10DLC messaging is typically required for companies outside the Russell 3000 list as these companies are considered as prevetted. Smaller businesses, companies without EIN, unverified brands may require brand vetting.
 
 2. What happens when a brand is rejected during the 10DLC registration process?
 
@@ -95,7 +95,7 @@ Brand vetting for 10DLC messaging is typically required for companies outside th
    
 3. How are registration fees charged?
 
-   All fees for registration, including vetting fees, are charged at the time of submission and are non-refundable regardless of approval status.
+   All fees for registration, including vetting fees, are charged at the time of submission and are nonrefundable regardless of approval status.
 
 ## Next steps
 
diff --git a/articles/communication-services/quickstarts/sms/apply-for-ten-digit-long-code.md b/articles/communication-services/quickstarts/sms/apply-for-ten-digit-long-code.md
@@ -1,6 +1,6 @@
 ---
 title: Apply for 10 digit long code (10DLC) brand registration and campaign registration
-titleSuffix: An Azure Communication Services quickstart 
+titleSuffix: An Azure Communication Services article 
 description: This article describes how to apply for 10 digit long code (10DLC) brand registration and campaign registration.
 author: prakulka
 manager: darmour
@@ -123,7 +123,7 @@ Fill in the campaign and content attributes as follows:
    - **Subscriber Help**: Select **Yes** or **No** to indicate if subscriber help is available.
    - **Subscriber Help Answer**: If **Yes** is selected, provide the message for subscribers seeking assistance.
 
-#### Additional attributes
+#### More attributes
 
    - **Direct Lending or Loan Arrangement**: Indicate if the campaign involves any lending or loan arrangements.
    - **Embedded Link**: Select **Yes** or **No** to specify if the campaign includes an embedded link.
@@ -132,7 +132,7 @@ Fill in the campaign and content attributes as follows:
 
 #### Terms and conditions
 
-Affiliate marketing is not permitted on 10DLC numbers. Check the box to confirm that the campaign will not be used for Affiliate Marketing.
+Affiliate marketing isn't permitted on 10DLC numbers. Check the box to confirm that the campaign will not be used for Affiliate Marketing.
 
 :::image type="content" source="./media/apply-for-brand-registration/campaign-registration-4.png" alt-text="Screenshot showing campaign registration form 4." lightbox="./media/apply-for-brand-registration/campaign-registration-4.png":::
 
diff --git a/articles/communication-services/toc.yml b/articles/communication-services/toc.yml
@@ -40,6 +40,8 @@ items:
     href: concepts/identity-model.md
   - name: Access tokens for end users
     href: quickstarts/identity/access-tokens.md
+  - name: Sign an HTTP Request using HMAC
+    href: tutorials/hmac-header-tutorial.md
   - name: Authenticate services
     href: concepts/authentication.md
   - name: Enable managed identity
@@ -296,6 +298,8 @@ items:
     href: concepts/sms/messaging-policy.md
   - name: Short code program brief filling guidelines
     href: concepts/sms/program-brief-guidelines.md
+  - name: Ten digit long code (10DLC) registration guidelines
+    href: concepts/sms/ten-digit-long-code-guidelines.md
   - name: Opt-Out management overview
     href: concepts/sms/opt-out-api-concept.md
   - name: Events
@@ -332,10 +336,12 @@ items:
       href: quickstarts/sms/handle-sms-events.md
     - name: Apply for a short code
       href: quickstarts/sms/apply-for-short-code.md
-    - name: Use Postman to send SMS messages
-      href: tutorials/postman-tutorial.md
+#    - name: Use Postman to send SMS messages
+#      href: tutorials/postman-tutorial.md
     - name: Send short URL
       href: tutorials/sms-url-shortener.md
+    - name: Apply for 10 digit long code (10DLC) registration
+      href: quickstarts/sms/apply-for-ten-digit-long-code.md
     - name: Apply for toll-free verification
       href: quickstarts/sms/apply-for-toll-free-verification.md
     - name: Enable alphanumeric sender ID
diff --git a/articles/communication-services/tutorials/hmac-header-tutorial.md b/articles/communication-services/tutorials/hmac-header-tutorial.md
@@ -1,7 +1,7 @@
 ---
-title: Tutorial - Learn How to Sign an HTTP Request with HMAC
-titleSuffix: An Azure Communication Services tutorial
-description: Learn how to sign an HTTP request for Azure Communication Services by using HMAC.
+title: Sign an HTTP Request using hash-based message authentication code (HMAC)
+titleSuffix: An Azure Communication Services article
+description: This article describes how to sign an HTTP request for Azure Communication Services by using HMAC.
 author: alexandra142
 manager: soricos
 services: azure-communication-services
@@ -15,12 +15,12 @@ ms.custom: devx-track-python
 zone_pivot_groups: acs-programming-languages-csharp-python
 ---
 
-# Tutorial: Sign an HTTP request
+# Sign an HTTP request using hash-based message authentication code (HMAC)
 
-In this tutorial, you learn how to sign an HTTP request with a hash-based message authentication code (HMAC) signature.
+This article describes how to sign an HTTP request with a hash-based message authentication code (HMAC) signature.
 
 > [!NOTE]
-> We strongly encourage you to use [Azure SDKs](https://github.com/Azure/azure-sdk). The approach described here is a fallback option for cases when Azure SDKs can't be used for any reason.
+> We recommend using the [Azure SDKs](https://github.com/Azure/azure-sdk) to sign an HTTP request. The approach described in this article is a fallback option if Azure SDKs can't be used for any reason.
 
 In this tutorial, you learn how to:
 > [!div class="checklist"]
diff --git a/articles/communication-services/tutorials/includes/hmac-header-csharp.md b/articles/communication-services/tutorials/includes/hmac-header-csharp.md
@@ -1,6 +1,6 @@
 ---
 title: Sign an HTTP Request with C#
-description: This tutorial explains the C# version of signing an HTTP request with an HMAC signature for Azure Communication Services.
+description: This article describes how to use C# to sign an HTTP request with an HMAC signature for Azure Communication Services.
 author: alexandra142
 manager: soricos
 services: azure-communication-services
@@ -12,8 +12,6 @@ ms.service: azure-communication-services
 ---
 ## Prerequisites
 
-Before you get started, make sure to:
-
 - Create an Azure account with an active subscription. If you don't have an Azure subscription, see [Create an account for free](https://azure.microsoft.com/free/?WT.mc_id=A261C142F).
 - Install [Visual Studio](https://visualstudio.microsoft.com/downloads/).
 - Create an Azure Communication Services resource. If you don't have a resource, see [Create a Communication Services resource](../../quickstarts/create-communication-resource.md). You need to record your `resourceEndpoint` and `resourceAccessKey` parameters for this tutorial.
@@ -36,7 +34,7 @@ The `hmac-sha256-signature` consists of:
 
 ## Set up the authorization header
 
-The following steps describe how to construct the authorization header.
+Complete the following steps to construct the authorization header.
 
 ### Create a new C# application
 
@@ -46,7 +44,7 @@ In a console window, such as cmd, PowerShell, or Bash, use the `dotnet new` comm
 dotnet new console -o SignHmacTutorial
 ```
 
-Change your directory to the newly created app folder. Use the `dotnet build` command to compile your application.
+Change your directory to the newly created app folder. To compile your application, use the `dotnet build` command.
 
 ```console
 cd SignHmacTutorial
diff --git a/articles/communication-services/tutorials/includes/hmac-header-python.md b/articles/communication-services/tutorials/includes/hmac-header-python.md
@@ -1,6 +1,6 @@
 ---
 title: Sign an HTTP Request with Python
-description: This tutorial explains the Python version of signing an HTTP request with an HMAC signature for Azure Communication Services.
+description: This article describes how to use Python to sign an HTTP request with an HMAC signature for Azure Communication Services.
 author: maximrytych-ms
 manager: anitharaju
 services: azure-communication-services
@@ -12,12 +12,10 @@ ms.service: azure-communication-services
 ---
 ## Prerequisites
 
-Before you get started, make sure to:
-
 - Create an Azure account with an active subscription. If you don't have an Azure subscription, see [Create an account for free](https://azure.microsoft.com/free/?WT.mc_id=A261C142F).
 - Download and install [Python](https://www.python.org/).
 - Download and install [Visual Studio Code](https://code.visualstudio.com/) or another integrated development environment (IDE) that supports Python.
-- Create an Azure Communication Services resource. If you don't have a resource, see [Create a Communication Services resource](../../quickstarts/create-communication-resource.md). You need your `resource_endpoint_name` and `resource_endpoint_secret` parameters for this tutorial.
+- Create an Azure Communication Services resource. If you don't have a resource, see [Create a Communication Services resource](../../quickstarts/create-communication-resource.md). You need your `resource_endpoint_name` and `resource_endpoint_secret` parameters for this example.
 
 ## Sign an HTTP request with Python
 
@@ -37,7 +35,7 @@ The `hmac-sha256-signature` consists of:
 
 ## Set up the authorization header
 
-The following steps describe how to construct the authorization header.
+Complete following steps to construct the authorization header.
 
 ### Create a new Python script
 
