Skip to content

Commit c8e78fc

Browse files
authored
Merge pull request #277168 from sloanster/patch-14
Update sdk-options.md
2 parents c76ec11 + 605151c commit c8e78fc

File tree

1 file changed

+10
-7
lines changed

1 file changed

+10
-7
lines changed

articles/communication-services/concepts/sdk-options.md

Lines changed: 10 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,13 +1,13 @@
11
---
2-
title: SDK's and REST APIs for Azure Communication Services
2+
title: SDKs and REST APIs for Azure Communication Services
33
titleSuffix: An Azure Communication Services concept document
4-
description: Learn more about Azure Communication Services SDK's and REST APIs.
5-
author: tophpalmer
4+
description: Learn more about Azure Communication Services SDKs and REST APIs.
5+
author: sloanster
66
manager: chpalm
77
services: azure-communication-services
88

9-
ms.author: chpalm
10-
ms.date: 04/16/2024
9+
ms.author: micahvivion
10+
ms.date: 06/04/2024
1111
ms.topic: conceptual
1212
ms.service: azure-communication-services
1313
---
@@ -19,6 +19,9 @@ In the tables below we summarize these areas and availability of REST APIs and S
1919

2020
Development of Calling and Chat applications can be accelerated by the [Azure Communication Services UI library](./ui-library/ui-library-overview.md). The customizable UI library provides open-source UI components for Web and mobile apps, and a Microsoft Teams theme.
2121

22+
## Creating a practice to use the latest SDK
23+
Today's browsers versions and operating systems are always being upgraded to support the latest in advancement and to help fix outstanding bugs and issues. Using the latest Azure Communication Services SDK can help you achieve the best quality for your application when used with updated browsers and operating systems. The latest SDK and offers many benefits, such as improved performance, security, compatibility, and usability. It also allows you to take advantage of the newest features and updates that are constantly being added to the browser and operating system. Azure Communication Services SDKs are always upgraded regularly. It's recommended that you create a procress to ensure that you're always upgrading to the latest SDKs.
24+
2225
## SDKs
2326

2427
| Assembly | Protocols| Environment | Capabilities|
@@ -123,8 +126,8 @@ Communication Services APIs are documented alongside other [Azure REST APIs](/re
123126
124127
In the future we may retire versions of the Communication Services SDKs, and we may introduce breaking changes to our REST APIs and released SDKs. Azure Communication Services *generally* follows two supportability policies for retiring service versions:
125128

126-
- You'll be notified at least three years before being required to change code due to a Communication Services interface change. All documented REST APIs and SDK APIs generally enjoy at least three years warning before interfaces are decommissioned.
127-
- You'll be notified at least one year before having to update SDK assemblies to the latest minor version. These required updates shouldn't require any code changes because they're in the same major version. Using the latest SDK is especially important for the Calling and Chat libraries that real-time components that often require security and performance updates. We strongly encourage you to keep all your Communication Services SDKs updated.
129+
- You're notified at least three years before being required to change code due to a Communication Services interface change. All documented REST APIs and SDK APIs generally enjoy at least three years warning before interfaces are decommissioned.
130+
- You're notified at least one year before having to update SDK assemblies to the latest minor version. These required updates shouldn't require any code changes because they're in the same major version. Using the latest SDK is especially important for the Calling and Chat libraries that real-time components that often require security and performance updates. We strongly encourage you to keep all your Communication Services SDKs updated.
128131

129132
### API and SDK decommissioning examples
130133

0 commit comments

Comments
 (0)