AzurePipelinesCredential doc updates (Azure#46668)

Author: scottaddie

sdk/identity/Azure.Identity/README.md

@@ -241,7 +241,7 @@ Not all credentials require this configuration. Credentials that authenticate th
 
 |Credential | Usage | Reference
 |-|-|-
-|[`AzurePipelinesCredential`][ref_AzurePipelinesCredential]|Supports [Microsoft Entra Workload ID](https://learn.microsoft.com/azure/devops/pipelines/release/configure-workload-identity?view=azure-devops) on Azure Pipelines.| [example](https://github.com/Azure/azure-sdk-for-net/blob/main/sdk/identity/Azure.Identity/samples/OtherCredentialSamples.md#AzurePipelinesCredential_example)
+|[`AzurePipelinesCredential`][ref_AzurePipelinesCredential]|Supports [Microsoft Entra Workload ID](https://learn.microsoft.com/azure/devops/pipelines/release/configure-workload-identity?view=azure-devops) on Azure Pipelines.| [example](https://aka.ms/azsdk/net/identity/azurepipelinescredential/usage)
 |[`ClientAssertionCredential`][ref_ClientAssertionCredential]|Authenticates a service principal using a signed client assertion. |
 |[`ClientCertificateCredential`][ref_ClientCertificateCredential]|Authenticates a service principal using a certificate. | [Service principal authentication](https://learn.microsoft.com/entra/identity-platform/app-objects-and-service-principals)
 |[`ClientSecretCredential`][ref_ClientSecretCredential]|Authenticates a service principal using a secret. | [Service principal authentication](https://learn.microsoft.com/entra/identity-platform/app-objects-and-service-principals)

sdk/identity/Azure.Identity/samples/OtherCredentialSamples.md

@@ -5,7 +5,7 @@
 To set up a federated identity credential (FIC) in Azure Pipelines, you can set up the Azure Resource Manager service connection as an [automatic recommended approach](https://learn.microsoft.com/azure/devops/pipelines/library/connect-to-azure?view=azure-devops#create-an-azure-resource-manager-service-connection-that-uses-workload-identity-federation).
 You can also create it manually either using a [user-assigned managed identity to accept the ADO-issued token as a FIC](https://learn.microsoft.com/azure/devops/pipelines/release/configure-workload-identity?view=azure-devops#set-a-workload-identity-service-connection-to-use-managed-identity-authentication) or using an [App Registration to accept the Azure DevOps-issued token as a FIC](https://learn.microsoft.com/azure/devops/pipelines/release/configure-workload-identity?view=azure-devops#set-a-workload-identity-service-connection-to-use-service-principal-authentication).
 
-Make sure you use one of the [recommended Azure Pipelines tasks](https://learn.microsoft.com/azure/devops/pipelines/release/troubleshoot-workload-identity?view=azure-devops#review-pipeline-tasks) so that FIC is available in Azure Pipelines.
+Make sure you use one of the [recommended Azure Pipelines tasks][az_pipelines_tasks] so that FIC is available in Azure Pipelines.
 
 To use `AzurePipelinesCredential`, configure the following values in the constructor:
 
@@ -17,7 +17,7 @@ To use `AzurePipelinesCredential`, configure the following values in the constru
 
 ## Example of using an Azure Pipelines task
 
-The following task YAML is an example of configuring the [AzureCLI@2](https://learn.microsoft.com/azure/devops/pipelines/tasks/reference/azure-cli-v2?view=azure-pipelines) task for using service connections federated identity with @azure/identity. See the list of [recommended Azure Pipelines tasks](https://learn.microsoft.com/azure/devops/pipelines/release/troubleshoot-workload-identity?view=azure-devops#review-pipeline-tasks).
+The following task YAML is an example of configuring the [AzureCLI@2](https://learn.microsoft.com/azure/devops/pipelines/tasks/reference/azure-cli-v2?view=azure-pipelines) task for using service connections federated identity with the Azure Identity library. See the list of [recommended Azure Pipelines tasks][az_pipelines_tasks].
 
 ```yml
 trigger:
@@ -93,3 +93,6 @@ var credential = new OnBehalfOfCredential(tenantId, clientId, getManagedIdentity
 // Use the credential to authenticate with the Key Vault client.
 var client = new SecretClient(new Uri("https://keyvault-name.vault.azure.net/"), credential);
 ```
+
+<!-- LINKS -->
+[az_pipelines_tasks]: https://aka.ms/azdo-rm-workload-identity-tasks

sdk/identity/Azure.Identity/src/Credentials/AzurePipelinesCredential.cs

@@ -12,7 +12,9 @@
 namespace Azure.Identity
 {
     /// <summary>
-    /// Credential which authenticates using an Azure Pipelines service connection.
+    /// Credential which authenticates using an Azure Pipelines service connection. For usage instructions, see
+    /// <see href="https://aka.ms/azsdk/net/identity/azurepipelinescredential/usage">Authenticating in Azure
+    /// Pipelines with service connections</see>.
     /// </summary>
     public class AzurePipelinesCredential : TokenCredential
     {