Skip to content

Commit 7e9ba37

Browse files
authored
Update root readme to reflect Track 2 management packages (Azure#12944)
* Update root readme for track 2 .net packages * Update mgmt quickstart * Update quickstart * Update root readme * Re-trigger CI
1 parent 82faf35 commit 7e9ba37

File tree

2 files changed

+23
-4
lines changed

2 files changed

+23
-4
lines changed

README.md

+18-3
Original file line numberDiff line numberDiff line change
@@ -11,8 +11,13 @@ To get started with a library, see the README.md file located in the library's p
1111
For tutorials, samples, quick starts, and other documentation, go to [Azure for .NET Developers](https://docs.microsoft.com/en-us/dotnet/azure/).
1212

1313
## Packages available
14+
Each service might have a number of libraries available from each of the following categories:
15+
* [Client - New Releases](#Client-New-Releases)
16+
* [Client - Previous Versions](#Client-Previous-Versions)
17+
* [Management - New Releases](#Management-New-Releases)
18+
* [Management - Previous Versions](#Management-Previous-Versions)
1419

15-
### Client
20+
### Client: New Releases
1621

1722
New wave of packages that we are announcing as **GA** and several that are currently releasing in **preview**. These libraries follow the [Azure SDK Design Guidelines for .NET](https://azure.github.io/azure-sdk/dotnet/guidelines/) and share a number of core features such as HTTP retries, logging, transport protocols, authentication protocols, etc., so that once you learn how to use these features in one client library, you will know how to use them in other client libraries. You can learn about these shared features at [Azure.Core](sdk/core/Azure.Core/README.md).
1823

@@ -26,9 +31,19 @@ For a complete list of available packages, please see the [latest available pack
2631

2732
Last stable versions of packages that are production-ready. These libraries provide similar functionalities to the preview packages, as they allow you to use and consume existing resources and interact with them, for example: upload a storage blob. Stable library directories typically contain 'Microsoft.Azure' in their names, e.g. 'Microsoft.Azure.KeyVault'. They might not implement the [guidelines](https://azure.github.io/azure-sdk/dotnet_introduction.html) or have the same feature set as the Novemeber releases. They do however offer wider coverage of services.
2833

29-
### Management
34+
### Management: New Releases
3035

31-
Libraries which enable you to provision specific server resources. They are directly mirroring Azure service's REST endpoints. Management library directories typically contain the word 'Management' in their names, e.g. 'Microsoft.Azure.Management.Storage'.
36+
A new set of management libraries that follow the [Azure SDK Design Guidelines for .NET](https://azure.github.io/azure-sdk/dotnet_introduction.html) and based on [Azure.Core libraries](https://github.com/Azure/azure-sdk-for-net/tree/master/sdk/core/Azure.Core) are now in Public Preview. These new libraries provide a number of core capabilities that are shared amongst all Azure SDKs, including the intuitive Azure Identity library, an HTTP Pipeline with custom policies, error-handling, distributed tracing, and much more. You can find the list of new packages [on this page](https://azure.github.io/azure-sdk/releases/latest/dotnet.html).
37+
38+
To get started with these new libraries, please see the [quickstart guide here](https://github.com/Azure/azure-sdk-for-net/blob/master/doc/mgmt_preview_quickstart.md). These new libraries can be identifed by namespaces that start with `Azure.ResourceManager`, e.g. `Azure.ResourceManager.Network`
39+
40+
> NOTE: If you need to ensure your code is ready for production use one of the stable, non-preview libraries.
41+
42+
### Management: Previous Versions
43+
44+
For a complete list of management libraries which enable you to provision and manage Azure resources, please check [here](https://azure.github.io/azure-sdk/releases/latest/all/dotnet.html). They might not have the same feature set as the new releases but they do offer wider coverage of services. Previous versions of management libraries can be identified by namespaces that start with `Microsoft.Azure.Management`, e.g. `Microsoft.Azure.Management.Network`
45+
46+
Documentation and code samples for these libraries can be found [here](https://azure.github.io/azure-sdk-for-net).
3247

3348
## Need help?
3449

doc/mgmt_preview_quickstart.md

+5-1
Original file line numberDiff line numberDiff line change
@@ -305,7 +305,11 @@ namespace AzureCreateVMSample
305305
}
306306
}
307307
```
308-
308+
## Code Samples
309+
310+
More code samples for using the management library for .NET can be found in the following locations
311+
- [.NET Management Library Code Samples](https://docs.microsoft.com/en-us/samples/browse/?branch=master&languages=csharp&term=managing%20using%20Azure%20.NET%20SDK&terms=managing%20using%20Azure%20.NET%20SDK)
312+
309313
Need help?
310314
----------
311315

0 commit comments

Comments
 (0)