Merge pull request #211501 from DominikMe/communication-identifier-followup

prmerger-automator[bot] · web-flow · commit facb660ac6a5 · 2022-09-15T23:23:40.000Z
Address feedback on title sentence casing from previous pr 209047
diff --git a/articles/communication-services/concepts/identifiers.md b/articles/communication-services/concepts/identifiers.md
@@ -14,7 +14,7 @@ ms.subservice: identity
 zone_pivot_groups: acs-js-csharp-java-python-ios-android-rest
 ---
 
-# Understand Identifier types
+# Understand identifier types
 
 Communication Services SDKs and REST APIs use the *identifier* type to identify who is communicating with whom. For example, identifiers specify who to call, or who has sent a chat message.
 
diff --git a/articles/communication-services/concepts/includes/identifiers/identifiers-android.md b/articles/communication-services/concepts/includes/identifiers/identifiers-android.md
@@ -13,7 +13,7 @@ ms.custom: include file
 ms.author: domessin
 ---
 
-### Communication User identifier
+### Communication user
 
 The `CommunicationUserIdentifier` represents a user identity that was created using the [Identity SDK or REST API](../../../quickstarts/access-tokens.md). It's the only identifier used if your application doesn't use Microsoft Teams interoperability or Telephony features.
 
@@ -33,7 +33,7 @@ var sameUser = new CommunicationUserIdentifier(newUserId);
 
 [CommunicationUserIdentifier](https://azure.github.io/azure-sdk-for-android/azure-communication-common/com/azure/android/communication/common/CommunicationUserIdentifier.html)
 
-### Microsoft Teams User identifier
+### Microsoft Teams user
 
 The `MicrosoftTeamsUserIdentifier` represents a Teams user with its Azure AD user object ID. You can retrieve the Azure AD user object ID via the [Microsoft Graph REST API /users](/graph/api/user-get) endpoint from the `id` property in the response. For more information on how to work with Microsoft Graph, try the [Graph Explorer](https://developer.microsoft.com/en-us/graph/graph-explorer?request=users%2F%7Buser-mail%7D&method=GET&version=v1.0&GraphUrl=https://graph.microsoft.com) and look into the [Graph SDK](/graph/sdks/sdks-overview). Alternatively, you can find the ID as the `oid` claim in an [Azure AD ID token](/azure/active-directory/develop/id-tokens#payload-claims) or [Azure AD access token](/azure/active-directory/develop/access-tokens#payload-claims) after your user has signed in and acquired a token.
 
@@ -56,7 +56,7 @@ var gcchTeamsUser = new MicrosoftTeamsUserIdentifier(userId).setCloudEnvironment
 
 [MicrosoftTeamsUserIdentifier](https://azure.github.io/azure-sdk-for-android/azure-communication-common/com/azure/android/communication/common/MicrosoftTeamsUserIdentifier.html)
 
-### Phone Number identifier
+### Phone number
 
 The `PhoneNumberIdentifier` represents a phone number. The service assumes that phone numbers are formatted in E.164 format.
 
@@ -71,7 +71,7 @@ var phoneNumber = new PhoneNumberIdentifier("+112345556789");
 
 [PhoneNumberIdentifier](https://azure.github.io/azure-sdk-for-android/azure-communication-common/com/azure/android/communication/common/PhoneNumberIdentifier.html)
 
-### Unknown identifier
+### Unknown
 
 The `UnknownIdentifier` exists for future-proofing and you might encounter it when you are on an old version of the SDK and a new identifier type has been introduced recently. Any unknown identifier from the service will be deserialized to the `UnknownIdentifier` in the SDK.
 
diff --git a/articles/communication-services/concepts/includes/identifiers/identifiers-ios.md b/articles/communication-services/concepts/includes/identifiers/identifiers-ios.md
@@ -13,7 +13,7 @@ ms.custom: include file
 ms.author: domessin
 ---
 
-### Communication User identifier
+### Communication user
 
 The `CommunicationUserIdentifier` represents a user identity that was created using the [Identity SDK or REST API](../../../quickstarts/access-tokens.md). It's the only identifier used if your application doesn't use Microsoft Teams interoperability or Telephony features.
 
@@ -31,7 +31,7 @@ let user = CommunicationUserIdentifier(newUserId)
 
 [CommunicationUserIdentifier](https://azure.github.io/azure-sdk-for-ios/AzureCommunicationCommon/Classes/CommunicationUserIdentifier.html)
 
-### Microsoft Teams User identifier
+### Microsoft Teams user
 
 The `MicrosoftTeamsUserIdentifier` represents a Teams user with its Azure AD user object ID. You can retrieve the Azure AD user object ID via the [Microsoft Graph REST API /users](/graph/api/user-get) endpoint from the `id` property in the response. For more information on how to work with Microsoft Graph, try the [Graph Explorer](https://developer.microsoft.com/en-us/graph/graph-explorer?request=users%2F%7Buser-mail%7D&method=GET&version=v1.0&GraphUrl=https://graph.microsoft.com) and look into the [Graph SDK](/graph/sdks/sdks-overview). Alternatively, you can find the ID as the `oid` claim in an [Azure AD ID token](/azure/active-directory/develop/id-tokens#payload-claims) or [Azure AD access token](/azure/active-directory/develop/access-tokens#payload-claims) after your user has signed in and acquired a token.
 
@@ -52,7 +52,7 @@ gcchTeamsUser = MicrosoftTeamsUserIdentifier(userId: userId, cloud: Communicatio
 
 [MicrosoftTeamsUserIdentifier](https://azure.github.io/azure-sdk-for-ios/AzureCommunicationCommon/Classes/MicrosoftTeamsUserIdentifier.html)
 
-### Phone Number identifier
+### Phone number
 
 The `PhoneNumberIdentifier` represents a phone number. The service assumes that phone numbers are formatted in E.164 format.
 
@@ -67,7 +67,7 @@ let phoneNumber = PhoneNumberIdentifier(phoneNumber: "+112345556789")
 
 [PhoneNumberIdentifier](https://azure.github.io/azure-sdk-for-ios/AzureCommunicationCommon/Classes/PhoneNumberIdentifier.html)
 
-### Unknown identifier
+### Unknown
 
 The `UnknownIdentifier` exists for future-proofing and you might encounter it when you are on an old version of the SDK and a new identifier type has been introduced recently. Any unknown identifier from the service will be deserialized to the `UnknownIdentifier` in the SDK.
 
diff --git a/articles/communication-services/concepts/includes/identifiers/identifiers-java.md b/articles/communication-services/concepts/includes/identifiers/identifiers-java.md
@@ -13,7 +13,7 @@ ms.custom: include file
 ms.author: domessin
 ---
 
-### Communication User identifier
+### Communication user
 
 The `CommunicationUserIdentifier` represents a user identity that was created using the [Identity SDK or REST API](../../../quickstarts/access-tokens.md). It's the only identifier used if your application doesn't use Microsoft Teams interoperability or Telephony features.
 
@@ -33,7 +33,7 @@ var sameUser = new CommunicationUserIdentifier(newUserId);
 
 [CommunicationUserIdentifier](/java/api/com.azure.communication.common.communicationuseridentifier)
 
-### Microsoft Teams User identifier
+### Microsoft Teams user
 
 The `MicrosoftTeamsUserIdentifier` represents a Teams user with its Azure AD user object ID. You can retrieve the Azure AD user object ID via the [Microsoft Graph REST API /users](/graph/api/user-get) endpoint from the `id` property in the response. For more information on how to work with Microsoft Graph, try the [Graph Explorer](https://developer.microsoft.com/en-us/graph/graph-explorer?request=users%2F%7Buser-mail%7D&method=GET&version=v1.0&GraphUrl=https://graph.microsoft.com) and look into the [Graph SDK](/graph/sdks/sdks-overview). Alternatively, you can find the ID as the `oid` claim in an [Azure AD ID token](/azure/active-directory/develop/id-tokens#payload-claims) or [Azure AD access token](/azure/active-directory/develop/access-tokens#payload-claims) after your user has signed in and acquired a token.
 
@@ -56,7 +56,7 @@ var gcchTeamsUser = new MicrosoftTeamsUserIdentifier(userId).setCloudEnvironment
 
 [MicrosoftTeamsUserIdentifier](/java/api/com.azure.communication.common.microsoftteamsuseridentifier)
 
-### Phone Number identifier
+### Phone number
 
 The `PhoneNumberIdentifier` represents a phone number. The service assumes that phone numbers are formatted in E.164 format.
 
@@ -71,7 +71,7 @@ var phoneNumber = new PhoneNumberIdentifier("+112345556789");
 
 [PhoneNumberIdentifier](/java/api/com.azure.communication.common.phonenumberidentifier)
 
-### Unknown identifier
+### Unknown
 
 The `UnknownIdentifier` exists for future-proofing and you might encounter it when you are on an old version of the SDK and a new identifier type has been introduced recently. Any unknown identifier from the service will be deserialized to the `UnknownIdentifier` in the SDK.
 
diff --git a/articles/communication-services/concepts/includes/identifiers/identifiers-js.md b/articles/communication-services/concepts/includes/identifiers/identifiers-js.md
@@ -13,7 +13,7 @@ ms.custom: include file
 ms.author: domessin
 ---
 
-### Communication User identifier
+### Communication user
 
 The `CommunicationUserIdentifier` interface represents a user identity that was created using the [Identity SDK or REST API](../../../quickstarts/access-tokens.md). It's the only identifier used if your application doesn't use Microsoft Teams interoperability or Telephony features.
 
@@ -33,7 +33,7 @@ const sameUser = { communicationUserId: newUserId };
 
 [CommunicationUserIdentifier](/javascript/api/@azure/communication-common/communicationuseridentifier)
 
-### Microsoft Teams User identifier
+### Microsoft Teams user
 
 The `MicrosoftTeamsUserIdentifier` interface represents a Teams user with its Azure AD user object ID. You can retrieve the Azure AD user object ID via the [Microsoft Graph REST API /users](/graph/api/user-get) endpoint from the `id` property in the response. For more information on how to work with Microsoft Graph, try the [Graph Explorer](https://developer.microsoft.com/en-us/graph/graph-explorer?request=users%2F%7Buser-mail%7D&method=GET&version=v1.0&GraphUrl=https://graph.microsoft.com) and look into the [Graph SDK](/graph/sdks/sdks-overview). Alternatively, you can find the ID as the `oid` claim in an [Azure AD ID token](/azure/active-directory/develop/id-tokens#payload-claims) or [Azure AD access token](/azure/active-directory/develop/access-tokens#payload-claims) after your user has signed in and acquired a token.
 
@@ -54,7 +54,7 @@ const gcchTeamsUser = { microsoftTeamsUserId: userId, cloud: "gcch" };
 
 [MicrosoftTeamsUserIdentifier](/javascript/api/@azure/communication-common/microsoftteamsuseridentifier)
 
-### Phone Number identifier
+### Phone number
 
 The `PhoneNumberIdentifier` interface represents a phone number. The service assumes that phone numbers are formatted in E.164 format.
 
@@ -69,7 +69,7 @@ const phoneNumber = { phoneNumber: "+112345556789" };
 
 [PhoneNumberIdentifier](/javascript/api/@azure/communication-common/phonenumberidentifier)
 
-### Unknown identifier
+### Unknown
 
 The `UnknownIdentifier` interface exists for future-proofing and you might encounter it when you are on an old version of the SDK and a new identifier type has been introduced recently. Any unknown identifier from the service will be deserialized to the `UnknownIdentifier` in the SDK.
 
diff --git a/articles/communication-services/concepts/includes/identifiers/identifiers-net.md b/articles/communication-services/concepts/includes/identifiers/identifiers-net.md
@@ -13,7 +13,7 @@ ms.custom: include file
 ms.author: domessin
 ---
 
-### Communication User identifier
+### Communication user
 
 The `CommunicationUserIdentifier` represents a user identity that was created using the [Identity SDK or REST API](../../../quickstarts/access-tokens.md). It's the only identifier used if your application doesn't use Microsoft Teams interoperability or Telephony features.
 
@@ -33,7 +33,7 @@ var sameUser = new CommunicationUserIdentifier(newUserId);
 
 [CommunicationUserIdentifier](/dotnet/api/azure.communication.communicationuseridentifier)
 
-### Microsoft Teams User identifier
+### Microsoft Teams user
 
 The `MicrosoftTeamsUserIdentifier` represents a Teams user with its Azure AD user object ID. You can retrieve the Azure AD user object ID via the [Microsoft Graph REST API /users](/graph/api/user-get) endpoint from the `id` property in the response. For more information on how to work with Microsoft Graph, try the [Graph Explorer](https://developer.microsoft.com/en-us/graph/graph-explorer?request=users%2F%7Buser-mail%7D&method=GET&version=v1.0&GraphUrl=https://graph.microsoft.com) and look into the [Graph SDK](/graph/sdks/sdks-overview). Alternatively, you can find the ID as the `oid` claim in an [Azure AD ID token](/azure/active-directory/develop/id-tokens#payload-claims) or [Azure AD access token](/azure/active-directory/develop/access-tokens#payload-claims) after your user has signed in and acquired a token.
 
@@ -56,7 +56,7 @@ var gcchTeamsUser = new MicrosoftTeamsUserIdentifier(userId: userId, cloud: Comm
 
 [MicrosoftTeamsUserIdentifier](/dotnet/api/azure.communication.microsoftteamsuseridentifier)
 
-### Phone Number identifier
+### Phone number
 
 The `PhoneNumberIdentifier` represents a phone number. The service assumes that phone numbers are formatted in E.164 format.
 
@@ -71,7 +71,7 @@ var phoneNumber = new PhoneNumberIdentifier("+112345556789");
 
 [PhoneNumberIdentifier](/dotnet/api/azure.communication.phonenumberidentifier)
 
-### Unknown identifier
+### Unknown
 
 The `UnknownIdentifier` exists for future-proofing and you might encounter it when you are on an old version of the SDK and a new identifier type has been introduced recently. Any unknown identifier from the service will be deserialized to the `UnknownIdentifier` in the SDK.
 
diff --git a/articles/communication-services/concepts/includes/identifiers/identifiers-python.md b/articles/communication-services/concepts/includes/identifiers/identifiers-python.md
@@ -13,7 +13,7 @@ ms.custom: include file
 ms.author: domessin
 ---
 
-### Communication User identifier
+### Communication user
 
 The `CommunicationUserIdentifier` represents a user identity that was created using the [Identity SDK or REST API](../../../quickstarts/access-tokens.md). It's the only identifier used if your application doesn't use Microsoft Teams interoperability or Telephony features.
 
@@ -33,7 +33,7 @@ same_user = CommunicationUserIdentifier(new_user_id)
 
 [CommunicationUserIdentifier](/python/api/azure-communication-chat/azure.communication.chat.communicationuseridentifier)
 
-### Microsoft Teams User identifier
+### Microsoft Teams user
 
 The `MicrosoftTeamsUserIdentifier` represents a Teams user with its Azure AD user object ID. You can retrieve the Azure AD user object ID via the [Microsoft Graph REST API /users](/graph/api/user-get) endpoint from the `id` property in the response. For more information on how to work with Microsoft Graph, try the [Graph Explorer](https://developer.microsoft.com/en-us/graph/graph-explorer?request=users%2F%7Buser-mail%7D&method=GET&version=v1.0&GraphUrl=https://graph.microsoft.com) and look into the [Graph SDK](/graph/sdks/sdks-overview). Alternatively, you can find the ID as the `oid` claim in an [Azure AD ID token](/azure/active-directory/develop/id-tokens#payload-claims) or [Azure AD access token](/azure/active-directory/develop/access-tokens#payload-claims) after your user has signed in and acquired a token.
 
@@ -54,7 +54,7 @@ gcch_teams_user = MicrosoftTeamsUserIdentifier(user_id, cloud=CommunicationCloud
 
 [MicrosoftTeamsUserIdentifier](/python/api/azure-communication-chat/azure.communication.chat.microsoftteamsuseridentifier)
 
-### Phone Number identifier
+### Phone number
 
 The `PhoneNumberIdentifier` represents a phone number. The service assumes that phone numbers are formatted in E.164 format.
 
@@ -69,7 +69,7 @@ phone_number = PhoneNumberIdentifier("+112345556789")
 
 [PhoneNumberIdentifier](/python/api/azure-communication-chat/azure.communication.chat.phonenumberidentifier)
 
-### Unknown identifier
+### Unknown
 
 The `UnknownIdentifier` exists for future-proofing and you might encounter it when you are on an old version of the SDK and a new identifier type has been introduced recently. Any unknown identifier from the service will be deserialized to the `UnknownIdentifier` in the SDK.
 
diff --git a/articles/communication-services/concepts/includes/identifiers/identifiers-rest.md b/articles/communication-services/concepts/includes/identifiers/identifiers-rest.md
@@ -15,7 +15,7 @@ ms.author: domessin
 
 In REST APIs, the identifier is a polymorphic type: you construct a JSON object and a property that maps to a concrete identifier subtype. For convenience and backwards-compatibility reasons, the `kind` and `rawId` properties are optional in requests but get populated in service responses.
 
-### Communication User identifier
+### Communication user
 
 The `CommunicationUserIdentifierModel` represents a user identity that was created using the [Identity SDK or REST API](../../../quickstarts/access-tokens.md). It's the only identifier used if your application doesn't use Microsoft Teams interoperability or Telephony features.
 
@@ -48,7 +48,7 @@ You can find an example for a request that includes an identifier in Chat's REST
 
 [CommunicationUserIdentifierModel](https://github.com/Azure/azure-rest-api-specs/blob/c1883ee5b87c41dfcb699420409bc0e31cff0786/specification/communication/data-plane/Common/stable/2022-07-13/common.json#L113)
 
-### Microsoft Teams User identifier
+### Microsoft Teams user
 
 The `MicrosoftTeamsUserIdentifierModel` represents a Teams user with its Azure AD user object ID. You can retrieve the Azure AD user object ID via the [Microsoft Graph REST API /users](/graph/api/user-get) endpoint from the `id` property in the response. For more information on how to work with Microsoft Graph, try the [Graph Explorer](https://developer.microsoft.com/en-us/graph/graph-explorer?request=users%2F%7Buser-mail%7D&method=GET&version=v1.0&GraphUrl=https://graph.microsoft.com) and look into the [Graph SDK](/graph/sdks/sdks-overview). Alternatively, you can find the ID as the `oid` claim in an [Azure AD ID token](/azure/active-directory/develop/id-tokens#payload-claims) or [Azure AD access token](/azure/active-directory/develop/access-tokens#payload-claims) after your user has signed in and acquired a token.
 
@@ -96,7 +96,7 @@ The `MicrosoftTeamsUserIdentifierModel` represents a Teams user with its Azure A
 
 [MicrosoftTeamsUserIdentifierModel](https://github.com/Azure/azure-rest-api-specs/blob/c1883ee5b87c41dfcb699420409bc0e31cff0786/specification/communication/data-plane/Common/stable/2022-07-13/common.json#L139)
 
-### Phone Number identifier
+### Phone number
 
 The `PhoneNumberIdentifierModel` represents a phone number. The service assumes that phone numbers are formatted in E.164 format.
 
@@ -124,7 +124,7 @@ The `PhoneNumberIdentifierModel` represents a phone number. The service assumes
 
 [PhoneNumberIdentifierModel](https://github.com/Azure/azure-rest-api-specs/blob/c1883ee5b87c41dfcb699420409bc0e31cff0786/specification/communication/data-plane/Common/stable/2022-07-13/common.json#L126)
 
-### Unknown identifier
+### Unknown
 
 If a new identifier gets introduced in a service, it will get downgraded to the `CommunicationIdentifierModel` if you are on an old API version.
 
@@ -273,7 +273,7 @@ The raw ID is the Teams visitor ID prefixed with `8:teamsvisitor:`. The Teams vi
 
 The raw ID is the E.164 formatted phone number without the leading `+` and prefixed with `4:`.
 
-### Unknown identifier
+### Unknown
 
 *Identifier:*
 ```json
