Merge pull request #295522 from vac0224/vc-operator-look-up-2025-03-08

Remove preview banner, fix include files not displayed

Author: JamesJBarnett

articles/communication-services/quickstarts/telephony/includes/number-lookup-java.md

@@ -1,7 +1,7 @@
-Get started with the Phone Numbers client library for Java to look up operator information for phone numbers, which can be used to determine whether and how to communicate with that phone number. Follow these steps to install the package and look up operator information about a phone number.
+Get started with the Phone Numbers client library for Java to look up operator information for phone numbers. Use the operator information to determine whether and how to communicate with that phone number. Follow these steps to install the package and look up operator information about a phone number.
 
 > [!NOTE]
-> Find the code for this quickstart on [GitHub](https://github.com/Azure-Samples/communication-services-java-quickstarts/tree/main/LookupNumber).
+> To view the source code for this example, see [Manage Phone Numbers - Java | GitHub](https://github.com/Azure-Samples/communication-services-java-quickstarts/tree/main/LookupNumber).
 
 ## Prerequisites
 
@@ -44,7 +44,7 @@ The public preview version of the SDK is published to a dev package feed. To con
 </repository>
 ```
 
-You may need to add or edit the `settings.xml` file in `${user.home}/.m2`
+You might need to add or edit the `settings.xml` file in `${user.home}/.m2`
 
 ```xml
 <server>
@@ -72,7 +72,7 @@ Add the following dependency elements to the group of dependencies in the **pom.
   <dependency>
     <groupId>com.azure</groupId>
     <artifactId>azure-communication-phonenumbers</artifactId>
-    <version>1.2.0-beta.3</version>
+    <version>1.2.0</version>
   </dependency>
 
   <dependency>
@@ -188,7 +188,7 @@ OperatorInformation operatorInfo = result.getValue().getValues().get(0);
 ```
 
 > [!WARNING]
-> Using this functionality will incur a charge to your account.
+> Using this function incurs a charge to your account.
 
 ### Use operator information
 
@@ -215,7 +215,7 @@ System.out.println(operatorInfo.getPhoneNumber() + " is a " + numberType + " num
     + operatorInfo.getIsoCountryCode() + " by " + operatorName);
 ```
 
-You may also use the operator information to determine whether to send an SMS. For more information on sending an SMS, see the [SMS Quickstart](../../sms/send.md).
+You can also use the operator information to determine whether to send an SMS. For more information, see [Send an SMS message](../../sms/send.md).
 
 ## Run the code
 
@@ -240,4 +240,4 @@ mvn exec:java -D"exec.mainClass"="com.communication.lookup.quickstart.App" -D"ex
 
 ## Sample code
 
-You can download the sample app from [GitHub](https://github.com/Azure-Samples/communication-services-java-quickstarts/tree/main/LookupNumber).
+You can download the sample app from [Manage Phone Numbers - Java | GitHub](https://github.com/Azure-Samples/communication-services-java-quickstarts/tree/main/LookupNumber).

articles/communication-services/quickstarts/telephony/includes/number-lookup-js.md

@@ -1,7 +1,7 @@
-Get started with the Phone Numbers client library for JavaScript to look up operator information for phone numbers, which can be used to determine whether and how to communicate with that phone number. Follow these steps to install the package and look up operator information about a phone number.
+Get started with the Phone Numbers client library for JavaScript to look up operator information for phone numbers. Use the operator information to determine whether and how to communicate with that phone number. Follow these steps to install the package and look up operator information about a phone number.
 
 > [!NOTE]
-> Find the code for this quickstart on [GitHub](https://github.com/Azure-Samples/communication-services-javascript-quickstarts/tree/main/lookup-phone-number).
+> To view the source code for this example, see [Manage Phone Numbers - JavaScript | GitHub](https://github.com/Azure-Samples/communication-services-javascript-quickstarts/tree/main/lookup-phone-number).
 
 ## Prerequisites
 
@@ -46,7 +46,7 @@ main();
 Use the `npm install` command to install the Azure Communication Services Phone Numbers client library for JavaScript.
 
 ```console
-npm install @azure/[email protected]-beta.4 --save
+npm install @azure/[email protected] --save
 ```
 
 The `--save` option adds the library as a dependency in your **package.json** file.
@@ -91,7 +91,7 @@ let searchResults = await phoneNumbersClient.searchOperatorInformation([ "<targe
 ```
 
 > [!WARNING]
-> Using this functionality will incur a charge to your account.
+> Using this function incurs a charge to your account.
 
 ### Use operator information
 
@@ -112,7 +112,7 @@ console.log(operatorInfo.phoneNumber + " is a " + (operatorInfo.numberType ? ope
     + operatorInfo.isoCountryCode + " by " + (operatorInfo.operatorDetails.name ? operatorInfo.operatorDetails.name : "an unknown operator"));
 ```
 
-You may also use the operator information to determine whether to send an SMS. For more information on sending an SMS, see the [SMS Quickstart](../../sms/send.md).
+You can also use the operator information to determine whether to send an SMS. For more information, see [Send an SMS message](../../sms/send.md).
 
 ## Run the code
 
@@ -124,4 +124,4 @@ node number-lookup-quickstart.js
 
 ## Sample code
 
-You can download the sample app from [GitHub](https://github.com/Azure-Samples/communication-services-javascript-quickstarts/tree/main/lookup-phone-number)).
+You can download the sample app from [Manage Phone Numbers - JavaScript | GitHub](https://github.com/Azure-Samples/communication-services-javascript-quickstarts/tree/main/lookup-phone-number)).

articles/communication-services/quickstarts/telephony/includes/number-lookup-net.md

@@ -1,7 +1,7 @@
-Get started with the Phone Numbers client library for C# to look up operator information for phone numbers, which can be used to determine whether and how to communicate with that phone number. Follow these steps to install the package and look up operator information about a phone number.
+Get started with the Phone Numbers client library for C# to look up operator information for phone numbers. Use the operator information to determine whether and how to communicate with that phone number. Follow these steps to install the package and look up operator information about a phone number.
 
 > [!NOTE]
-> Find the code for this quickstart on [GitHub](https://github.com/Azure-Samples/communication-services-dotnet-quickstarts/tree/main/LookupNumber).
+> To view the source code for this example, see [Manage Phone Numbers - C# | GitHub](https://github.com/Azure-Samples/communication-services-dotnet-quickstarts/tree/main/LookupNumber).
 
 ## Prerequisites
 
@@ -46,7 +46,7 @@ More detailed information and other options for connecting to the dev feed can b
 While still in the application directory, install the Azure Communication Services PhoneNumbers client library for .NET package by using the following command.
 
 ```console
-dotnet add package Azure.Communication.PhoneNumbers --version 1.3.0-beta.5
+dotnet add package Azure.Communication.PhoneNumbers --version 1.3.0
 ```
 
 Add a `using` directive to the top of **Program.cs** to include the `Azure.Communication` namespace.
@@ -114,7 +114,7 @@ OperatorInformationResult searchResult = await client.SearchOperatorInformationA
 ```
 
 > [!WARNING]
-> Using this functionality will incur a charge to your account.
+> Using this function incurs a charge to your account.
 
 ### Use operator information
 
@@ -134,7 +134,7 @@ OperatorInformation operatorInformation = searchResult.Values[0];
 Console.WriteLine($"{operatorInformation.PhoneNumber} is a {operatorInformation.NumberType ?? "unknown"} number, operated in {operatorInformation.IsoCountryCode} by {operatorInformation.OperatorDetails.Name ?? "an unknown operator"}");
 ```
 
-You may also use the operator information to determine whether to send an SMS. For more information on sending an SMS, see the [SMS Quickstart](../../sms/send.md).
+You can also use the operator information to determine whether to send an SMS. For more information about sending an SMS, see [Send an SMS message](../../sms/send.md).
 
 ## Run the code
 
@@ -146,4 +146,4 @@ dotnet run --interactive
 
 ## Sample code
 
-You can download the sample app from [GitHub](https://github.com/Azure-Samples/communication-services-dotnet-quickstarts/tree/main/LookupNumber).
+You can download the sample app from [Manage Phone Numbers - C# | GitHub](https://github.com/Azure-Samples/communication-services-dotnet-quickstarts/tree/main/LookupNumber).

articles/communication-services/quickstarts/telephony/includes/number-lookup-python.md

@@ -1,7 +1,7 @@
-Get started with the Phone Numbers client library for Python to look up operator information for phone numbers, which can be used to determine whether and how to communicate with that phone number. Follow these steps to install the package and look up operator information about a phone number.
+Get started with the Phone Numbers client library for Python to look up operator information for phone numbers. Use the operator information to determine whether and how to communicate with that phone number. Follow these steps to install the package and look up operator information about a phone number.
 
 > [!NOTE]
-> Find the code for this quickstart on [GitHub](https://github.com/Azure-Samples/communication-services-python-quickstarts/tree/main/lookup-phone-numbers-quickstart).
+> To view the source code for this example, see [Manage Phone Numbers - Python | GitHub](https://github.com/Azure-Samples/communication-services-python-quickstarts/tree/main/lookup-phone-numbers-quickstart).
 
 ## Prerequisites
 
@@ -44,7 +44,7 @@ except Exception as ex:
 While still in the application directory, install the Azure Communication Services PhoneNumbers client library for Python package by using the `pip install` command.
 
 ```console
-pip install azure-communication-phonenumbers==1.2.0b2
+pip install azure-communication-phonenumbers==1.2.0
 ```
 
 ## Code examples
@@ -107,11 +107,11 @@ To search for a phone number's operator information, call `search_operator_infor
 
 ```python
 options = { "include_additional_operator_details": True }
-operator_results = phone_numbers_client.search_operator_information("<target-phone-number>", options)
+operator_results = phone_numbers_client.search_operator_information("<target-phone-number>", options=options)
 ```
 
 > [!WARNING]
-> Using this functionality will incur a charge to your account.
+> Using this function incurs a charge to your account.
 
 ### Use operator information
 
@@ -138,7 +138,7 @@ else:
 print(str.format("{0} is a {1} number, operated in {2} by {3}", operator_information.phone_number, number_type, operator_information.iso_country_code, operator_name))
 ```
 
-You may also use the operator information to determine whether to send an SMS. For more information on sending an SMS, see the [SMS Quickstart](../../sms/send.md).
+You can also use the operator information to determine whether to send an SMS. For more information about sending an SMS, see [Send an SMS message](../../sms/send.md).
 
 ## Run the code
 
@@ -150,4 +150,4 @@ python number_lookup_sample.py
 
 ## Sample code
 
-You can download the sample app from [GitHub](https://github.com/Azure-Samples/communication-services-python-quickstarts/tree/main/lookup-phone-numbers-quickstart).
+You can download the sample app from [Manage Phone Numbers - Python | GitHub](https://github.com/Azure-Samples/communication-services-python-quickstarts/tree/main/lookup-phone-numbers-quickstart).

articles/communication-services/quickstarts/telephony/number-lookup.md

@@ -1,6 +1,6 @@
 ---
-title: Quickstart - Look up operator information for a phone number using Azure Communication Services
-description: Learn how to look up operator information for any phone number using Azure Communication Services.
+title: Look up operator information for a phone number using Azure Communication Services
+description: This article describes how to look up operator information for any phone number using Azure Communication Services.
 services: azure-communication-services
 author: ericasp
 manager: danielav
@@ -13,9 +13,7 @@ ms.author: ericasp
 zone_pivot_groups: acs-js-csharp-java-python
 ---
 
-# Quickstart: Look up operator information for a phone number using Azure Communication Services
-
-[!INCLUDE [Public Preview Notice](../../includes/public-preview-include.md)]
+# Look up operator information for a phone number using Azure Communication Services
 
 ::: zone pivot="programming-language-javascript"
 [!INCLUDE [JavaScript](./includes/number-lookup-js.md)]
@@ -37,12 +35,12 @@ zone_pivot_groups: acs-js-csharp-java-python
 
 Common questions and issues:
 
-- Changes to environment variables may not take effect in programs that are already running. If you notice your environment variables aren't working as expected, try closing and reopening any programs you're using to run and edit code.
-- The data returned by this endpoint is subject to various international laws and regulations, therefore the accuracy of the results depends on several factors. These factors include whether the number was ported, the country code, and the approval status of the caller. Based on these factors, operator information may not be available for some phone numbers or may reflect the original operator of the phone number, not the current operator.
+- Changes to environment variables might not take effect in programs that are already running. If you notice your environment variables aren't working as expected, try closing and reopening any programs you're using to run and edit code.
+- The data returned by this endpoint is subject to various international laws and regulations, therefore the accuracy of the results depends on several factors. These factors include whether the number was ported, the country code, and the approval status of the caller. Based on these factors, operator information might not be available for some phone numbers or could reflect the original operator of the phone number, not the current operator.
 
 ## Next steps
 
-In this quickstart you learned how to:
+This article described how to:
 > [!div class="checklist"]
 > * Look up number formatting
 > * Look up operator information for a phone number

articles/zone-pivot-groups.yml

@@ -517,6 +517,18 @@ groups:
     title: JavaScript
   - id: programming-language-java
     title: Java
+- id: acs-js-csharp-java-python
+  title: Programming languages
+  prompt: Choose a programming language
+  pivots:
+  - id: programming-language-javascript
+    title: JavaScript
+  - id: programming-language-csharp
+    title: C#
+  - id: programming-language-java
+    title: Java
+  - id: programming-language-python
+    title: Python
 - id: acs-js-csharp-java-python-azcli-ps
   title: Programming languages
   prompt: Choose a programming language