Merge pull request MicrosoftDocs#1266 from azure-sdk/onboarding-azure-communication-sms-774575

Docs.MS Release Updates for azure-communication-sms

Author: danieljurek

ci-configs/packages-preview.json

@@ -365,7 +365,7 @@
         "prefer_source_distribution": "true",
         "name": "azure-communication-sms",
         "install_type": "pypi",
-        "version": ">=1.0.0b3"
+        "version": ">=1.0.0b6"
       },
       "exclude_path": [
         "test*",

docs-ref-services/preview/communication-sms-readme.md

@@ -1,9 +1,9 @@
 ---
-title: Azure SMS client library for Python
+title: Azure Communication SMS Package client library for Python
 keywords: Azure, python, SDK, API, azure-communication-sms, communication
 author: maggiepint
 ms.author: magpint
-ms.date: 10/09/2020
+ms.date: 03/10/2021
 ms.topic: article
 ms.prod: azure
 ms.technology: azure
@@ -13,74 +13,105 @@ ms.service: communication
 
 [![Build Status](https://dev.azure.com/azure-sdk/public/_apis/build/status/azure-sdk-for-python.client?branchName=master)](https://dev.azure.com/azure-sdk/public/_build/latest?definitionId=46?branchName=master)
 
-# Azure SMS client library for Python - Version 1.0.0b3 
+# Azure Communication SMS Package client library for Python - Version 1.0.0b6 
 
 
-Azure Communication SMS client package is intended to be used to send SMS using an Azure Resource. 
+This package contains a Python SDK for Azure Communication Services for SMS.
+Read more about Azure Communication Services [here](https://docs.microsoft.com/azure/communication-services/overview)
 
-# Getting started
+[Source code](https://github.com/Azure/azure-sdk-for-python/blob/azure-communication-sms_1.0.0b6/sdk/communication/azure-communication-sms) | [Package (Pypi)](https://pypi.org/project/azure-communication-sms/) | [API reference documentation](https://github.com/Azure/azure-sdk-for-python/blob/azure-communication-sms_1.0.0b6/sdk/communication/azure-communication-sms) | [Product documentation](https://docs.microsoft.com/azure/communication-services/quickstarts/telephony-sms/send?pivots=programming-language-python)
 
-## Prerequisites
 
-* Python 2.7, or 3.5 or later is required to use this package.
-* You must have an [Azure subscription](https://azure.microsoft.com/free/)
-* You must have a phone number configured that is associated with an Azure subscription
 
-## Install the package
+## Getting started
+
+### Prerequisites
+
+- Python 2.7, or 3.5 or later is required to use this package.
+- A deployed Communication Services resource. You can use the [Azure Portal](https://docs.microsoft.com/azure/communication-services/quickstarts/create-communication-resource?tabs=windows&pivots=platform-azp) or the [Azure PowerShell](https://docs.microsoft.com/powershell/module/az.communication/new-azcommunicationservice) to set it up.
+- You must have a phone number configured that is associated with an Azure subscription
+
+### Install the package
 
 Install the Azure Communication SMS client library for Python with [pip](https://pypi.org/project/pip/):
 
 ```bash
-pip install azure-communication-sms --pre
+pip install azure-communication-sms
 ```
 
-# Key concepts
+## Key concepts
 
 Azure Communication SMS package is used to do following:
-- Send an SMS
+- Send SMS Messages
 
-# Examples
+## Examples
 
 The following section provides several code snippets covering some of the most common Azure Communication Services tasks, including:
 
-<!-- - [Client Initialization](#client-initialization)
-- [Sending an SMS](#sending-an-sms) -->
+- [Client Initialization](#client-initialization)
+- [Sending SMS Messages](#sending--zsms)
 
-## Client Initialization
+### Client Initialization
 
-To initialize the SMS Client, the connection string can be used to instantiate:
+To initialize the SMS Client, the connection string can be used to instantiate.
+Alternatively, you can also use Active Directory authentication using DefaultAzureCredential.
 
 ```Python
-connection_string = "COMMUNICATION_SERVICES_CONNECTION_STRING"
+from azure.communication.sms import SmsClient
+from azure.identity import DefaultAzureCredential
+
+connection_str = os.getenv('AZURE_COMMUNICATION_SERVICE_CONNECTION_STRING')
 sms_client = SmsClient.from_connection_string(connection_string)
+# To use Azure Active Directory Authentication (DefaultAzureCredential) make sure to have
+# AZURE_TENANT_ID, AZURE_CLIENT_ID and AZURE_CLIENT_SECRET as env variables.
+endpoint = os.getenv('AZURE_COMMUNICATION_SERVICE_ENDPOINT')
+sms_client = SmsClient(endpoint, DefaultAzureCredential())
 ```
 
-## Sending an SMS
+### Sending SMS Messages
 
 Once the client is initialized, the `.send()` method can be invoked:
 
 ```Python
-smsresponse = sms_client.send(
-    from_phone_number=PhoneNumber("<leased-phone-number>"),
-    to_phone_numbers=[PhoneNumber("<to-phone-number>")],
+from azure.communication.sms import SendSmsOptions
+
+sms_responses = sms_client.send(
+    from_phone_number=PhoneNumberIdentifier("<leased-phone-number>"),
+    to_phone_numbers=["<to-phone-number-1>", "<to-phone-number-2>", "<to-phone-number-3>"],
     message="Hello World via SMS",
-    send_sms_options=SendSmsOptions(enable_delivery_report=True)) # optional property
+    enable_delivery_report=True, # optional property
+    tag="custom-tag") # optional property
 ```
 
-- `leased-phone-number`: an SMS enabled phone number associated with your communication service
-- `to-phone-number`: the phone number you wish to send a message to
-- `send_sms_options`: an optional parameter that you can use to configure Delivery Reporting. This is useful for scenarios where you want to emit events when SMS messages are delivered.
+- `from_phone_number`: An SMS enabled phone number associated with your communication service.
+- `to_phone_numbers`: The phone numbers you wish to send a message to.
+- `message`: The message that you want to send.
+- `enable_delivery_report`: An optional parameter that you can use to configure delivery reporting. This is useful for scenarios where you want to emit events when SMS messages are delivered.
+- `tag`: An optional parameter that you can use to configure custom tagging.
+
+
+## Troubleshooting
+The Azure Communication Service Identity client will raise exceptions defined in [Azure Core](https://github.com/Azure/azure-sdk-for-python/blob/azure-communication-sms_1.0.0b6/sdk/core/azure-core/README.md).
+
+## Next steps
+### More sample code
+
+Please take a look at the [samples](https://github.com/Azure/azure-sdk-for-python/tree/azure-communication-sms_1.0.0b6/sdk/communication/azure-communication-sms/samples) directory for detailed examples of how to use this library to send an sms.
 
-# Troubleshooting
+## Provide Feedback
 
-Running into issues? This section should contain details as to what to do there.
+If you encounter any bugs or have suggestions, please file an issue in the [Issues](https://github.com/Azure/azure-sdk-for-python/issues) section of the project
 
-# Next steps
+## Contributing
 
-More sample code should go here, along with links out to the appropriate example tests.
+This project welcomes contributions and suggestions.  Most contributions require you to agree to a
+Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us the rights to use your contribution. For details, visit https://cla.microsoft.com.
 
-# Contributing
+When you submit a pull request, a CLA-bot will automatically determine whether you need to provide a CLA and decorate the
+PR appropriately (e.g., label, comment). Simply follow the instructions provided by the bot. You will only need to do this once across all repos using our CLA.
 
-If you encounter any bugs or have suggestions, please file an issue in the [Issues](<https://github.com/Azure/azure-sdk-for-python/issues>) section of the project.
+This project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).
+For more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.
 
-![Impressions](https://azure-sdk-impressions.azurewebsites.net/api/impressions/azure-sdk-for-python%2Fsdk%2Ftemplate%2Fazure-template%2FREADME.png)
+<!-- LINKS -->
+[azure_core]: https://github.com/Azure/azure-sdk-for-python/blob/azure-communication-sms_1.0.0b6/sdk/core/azure-core/README.md