Skip to content

Commit

Permalink
Update docs metadata and targeting for release of Azure.Core
Browse files Browse the repository at this point in the history
  • Loading branch information
@azure-sdk
azure-sdk committed Jun 3, 2021
1 parent 30bad3e commit 15ebc8d
Showing 1 changed file with 18 additions and 18 deletions.
36 changes: 18 additions & 18 deletions api/overview/azure/core-readme.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -3,15 +3,15 @@ title: Azure Core shared client library for .NET
keywords: Azure, dotnet, SDK, API, Azure.Core, core
author: maggiepint
ms.author: magpint
ms.date: 05/06/2021
ms.date: 06/03/2021
ms.topic: article
ms.prod: azure
ms.technology: azure
ms.devlang: dotnet
ms.service: core
---

# Azure Core shared client library for .NET - Version 1.14.0
# Azure Core shared client library for .NET - Version 1.15.0


Azure.Core provides shared primitives, abstractions, and helpers for modern .NET Azure SDK client libraries.
Expand Down Expand Up @@ -49,12 +49,12 @@ We guarantee that all client instance methods are thread-safe and independent of

### Additional concepts
<!-- CLIENT COMMON BAR -->
[Client options](https://github.com/Azure/azure-sdk-for-net/blob/Azure.Core_1.14.0/sdk/core/Azure.Core/README.md#configuring-service-clients-using-clientoptions) |
[Accessing the response](https://github.com/Azure/azure-sdk-for-net/blob/Azure.Core_1.14.0/sdk/core/Azure.Core/README.md#accessing-http-response-details-using-responset) |
[Long-running operations](https://github.com/Azure/azure-sdk-for-net/blob/Azure.Core_1.14.0/sdk/core/Azure.Core/README.md#consuming-long-running-operations-using-operationt) |
[Handling failures](https://github.com/Azure/azure-sdk-for-net/blob/Azure.Core_1.14.0/sdk/core/Azure.Core/README.md#reporting-errors-requestfailedexception) |
[Diagnostics](https://github.com/Azure/azure-sdk-for-net/blob/Azure.Core_1.14.0/sdk/core/Azure.Core/samples/Diagnostics.md) |
[Mocking](https://github.com/Azure/azure-sdk-for-net/blob/Azure.Core_1.14.0/sdk/core/Azure.Core/README.md#mocking) |
[Client options](https://github.com/Azure/azure-sdk-for-net/blob/Azure.Core_1.15.0/sdk/core/Azure.Core/README.md#configuring-service-clients-using-clientoptions) |
[Accessing the response](https://github.com/Azure/azure-sdk-for-net/blob/Azure.Core_1.15.0/sdk/core/Azure.Core/README.md#accessing-http-response-details-using-responset) |
[Long-running operations](https://github.com/Azure/azure-sdk-for-net/blob/Azure.Core_1.15.0/sdk/core/Azure.Core/README.md#consuming-long-running-operations-using-operationt) |
[Handling failures](https://github.com/Azure/azure-sdk-for-net/blob/Azure.Core_1.15.0/sdk/core/Azure.Core/README.md#reporting-errors-requestfailedexception) |
[Diagnostics](https://github.com/Azure/azure-sdk-for-net/blob/Azure.Core_1.15.0/sdk/core/Azure.Core/samples/Diagnostics.md) |
[Mocking](https://github.com/Azure/azure-sdk-for-net/blob/Azure.Core_1.15.0/sdk/core/Azure.Core/README.md#mocking) |
[Client lifetime](https://devblogs.microsoft.com/azure-sdk/lifetime-management-and-thread-safety-guarantees-of-azure-sdk-net-clients/)
<!-- CLIENT COMMON BAR -->

Expand Down Expand Up @@ -94,7 +94,7 @@ SecretClientOptions options = new SecretClientOptions()
SecretClient client = new SecretClient(new Uri("http://example.com"), new DefaultAzureCredential(), options);
```

More on client configuration in [client configuration samples](https://github.com/Azure/azure-sdk-for-net/blob/Azure.Core_1.14.0/sdk/core/Azure.Core/samples/Configuration.md)
More on client configuration in [client configuration samples](https://github.com/Azure/azure-sdk-for-net/blob/Azure.Core_1.15.0/sdk/core/Azure.Core/samples/Configuration.md)

### Accessing HTTP Response Details Using ```Response<T>```
_Service clients_ have methods that can be used to call Azure services.
Expand Down Expand Up @@ -127,7 +127,7 @@ foreach (HttpHeader header in http.Headers)
}
```

More on response types in [response samples](https://github.com/Azure/azure-sdk-for-net/blob/Azure.Core_1.14.0/sdk/core/Azure.Core/samples/Response.md)
More on response types in [response samples](https://github.com/Azure/azure-sdk-for-net/blob/Azure.Core_1.15.0/sdk/core/Azure.Core/samples/Response.md)

### Setting up console logging

Expand All @@ -138,7 +138,7 @@ To create an Azure SDK log listener that outputs messages to console use `AzureE
using AzureEventSourceListener listener = AzureEventSourceListener.CreateConsoleLogger();
```

More on logging in [diagnostics samples](https://github.com/Azure/azure-sdk-for-net/blob/Azure.Core_1.14.0/sdk/core/Azure.Core/samples/Diagnostics.md)
More on logging in [diagnostics samples](https://github.com/Azure/azure-sdk-for-net/blob/Azure.Core_1.15.0/sdk/core/Azure.Core/samples/Diagnostics.md)

### Reporting Errors ```RequestFailedException```

Expand All @@ -157,7 +157,7 @@ catch (RequestFailedException e) when (e.Status == 404)
}
```

More on handling responses in [response samples](https://github.com/Azure/azure-sdk-for-net/blob/Azure.Core_1.14.0/sdk/core/Azure.Core/samples/Response.md)
More on handling responses in [response samples](https://github.com/Azure/azure-sdk-for-net/blob/Azure.Core_1.15.0/sdk/core/Azure.Core/samples/Response.md)

### Consuming Service Methods Returning ```AsyncPageable<T>```

Expand All @@ -174,7 +174,7 @@ await foreach (SecretProperties secretProperties in allSecretProperties)
}
```

More on paged responses in [response samples](https://github.com/Azure/azure-sdk-for-net/blob/Azure.Core_1.14.0/sdk/core/Azure.Core/samples/Response.md)
More on paged responses in [response samples](https://github.com/Azure/azure-sdk-for-net/blob/Azure.Core_1.15.0/sdk/core/Azure.Core/samples/Response.md)

### Consuming Long-Running Operations Using ```Operation<T>```

Expand All @@ -196,7 +196,7 @@ Console.WriteLine(value.Name);
Console.WriteLine(value.ScheduledPurgeDate);
```

More on long-running operations in [long-running operation samples](https://github.com/Azure/azure-sdk-for-net/blob/Azure.Core_1.14.0/sdk/core/Azure.Core/samples/LongRunningOperations.md)
More on long-running operations in [long-running operation samples](https://github.com/Azure/azure-sdk-for-net/blob/Azure.Core_1.15.0/sdk/core/Azure.Core/samples/LongRunningOperations.md)

### Mocking
One of the most important cross-cutting features of our new client libraries using Azure.Core is that they are designed for mocking.
Expand Down Expand Up @@ -229,11 +229,11 @@ SecretClient client = mock.Object;
KeyVaultSecret secret = client.GetSecret("Name");
```

More on mocking in [mocking samples](https://github.com/Azure/azure-sdk-for-net/blob/Azure.Core_1.14.0/sdk/core/Azure.Core/samples/Mocking.md)
More on mocking in [mocking samples](https://github.com/Azure/azure-sdk-for-net/blob/Azure.Core_1.15.0/sdk/core/Azure.Core/samples/Mocking.md)

## Troubleshooting

Three main ways of troubleshooting failures are [inspecting exceptions](https://github.com/Azure/azure-sdk-for-net/blob/Azure.Core_1.14.0/sdk/core/Azure.Core/samples/Response.md#handling-exceptions), enabling [logging](https://github.com/Azure/azure-sdk-for-net/blob/Azure.Core_1.14.0/sdk/core/Azure.Core/samples/Diagnostics.md#Logging), and [distributed tracing](https://github.com/Azure/azure-sdk-for-net/blob/Azure.Core_1.14.0/sdk/core/Azure.Core/samples/Diagnostics.md#Distributed-tracing)
Three main ways of troubleshooting failures are [inspecting exceptions](https://github.com/Azure/azure-sdk-for-net/blob/Azure.Core_1.15.0/sdk/core/Azure.Core/samples/Response.md#handling-exceptions), enabling [logging](https://github.com/Azure/azure-sdk-for-net/blob/Azure.Core_1.15.0/sdk/core/Azure.Core/samples/Diagnostics.md#Logging), and [distributed tracing](https://github.com/Azure/azure-sdk-for-net/blob/Azure.Core_1.15.0/sdk/core/Azure.Core/samples/Diagnostics.md#Distributed-tracing)

## Next steps

Expand All @@ -243,13 +243,13 @@ Explore and install [available Azure SDK libraries](https://azure.github.io/azur

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.

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.
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 repositories using our CLA.

This project has adopted the [Microsoft Open Source Code of Conduct][code_of_conduct]. For more information see the [Code of Conduct FAQ][code_of_conduct_faq] or contact opencode@microsoft.com with any additional questions or comments.

![Impressions](https://azure-sdk-impressions.azurewebsites.net/api/impressions/azure-sdk-for-net%2Fsdk%2Fcore%2FAzure.Core%2FREADME.png)

[source]: https://github.com/Azure/azure-sdk-for-net/tree/Azure.Core_1.14.0/sdk/core/Azure.Core/src
[source]: https://github.com/Azure/azure-sdk-for-net/tree/Azure.Core_1.15.0/sdk/core/Azure.Core/src
[package]: https://www.nuget.org/packages/Azure.Core/
[docs]: https://azure.github.io/azure-sdk-for-net/core.html
[code_of_conduct]: https://opensource.microsoft.com/codeofconduct
Expand Down

0 comments on commit 15ebc8d

Please sign in to comment.