From acfd54ac00b178b243786df0ac65ff100eb28358 Mon Sep 17 00:00:00 2001
From: Weidong Xu <weidxu@microsoft.com>
Date: Mon, 19 Oct 2020 10:57:20 +0800
Subject: [PATCH] mgmt, update README and MIGRATION_GUIDE (#16426)

---
 sdk/resourcemanager/README.md               | 9 +++++++++
 sdk/resourcemanager/docs/MIGRATION_GUIDE.md | 5 +++++
 2 files changed, 14 insertions(+)

diff --git a/sdk/resourcemanager/README.md b/sdk/resourcemanager/README.md
index 8353c9cdc2c7f..6b9fe2100f662 100644
--- a/sdk/resourcemanager/README.md
+++ b/sdk/resourcemanager/README.md
@@ -304,6 +304,9 @@ or checkout [StackOverflow for Azure Java SDK](http://stackoverflow.com/question
 An `HttpClient` implementation must exist on the classpath.
 See [Include optional packages](#include-optional-packages).
 
+Latest `azure-identity` package specifies dependency on `azure-core-http-netty` package for convenience.
+If you would like to use a different `HttpClient`, please exclude `azure-core-http-netty` from `azure-identity`.
+
 ### Enabling logging
 
 Azure SDKs for Java offer a consistent logging story to help aid in troubleshooting application errors and expedite
@@ -319,6 +322,11 @@ AzureResourceManager azure = AzureResourceManager
     .withDefaultSubscription();
 ```
 
+### ARM throttling
+
+Azure Resource Manager applies throttling on the number of requests sent from client within certain span of time.
+For details, please refer to [Guidance on ARM throttling][throttling].
+
 ## Next steps
 
 ## Contributing
@@ -345,4 +353,5 @@ If you would like to become an active contributor to this project please follow
 [sample]: https://github.com/Azure/azure-sdk-for-java/blob/master/sdk/resourcemanager/docs/SAMPLE.md
 [design]: https://github.com/Azure/azure-sdk-for-java/blob/master/sdk/resourcemanager/docs/DESIGN.md
 [design_preview]: https://github.com/Azure/azure-sdk-for-java/blob/master/sdk/resourcemanager/docs/DESIGN_PREVIEW.md
+[throttling]: https://github.com/Azure/azure-sdk-for-java/blob/master/sdk/resourcemanager/docs/THROTTLING.md
 [reactor]: https://projectreactor.io/
diff --git a/sdk/resourcemanager/docs/MIGRATION_GUIDE.md b/sdk/resourcemanager/docs/MIGRATION_GUIDE.md
index 20c0a1d9932c2..8b95a29f68814 100644
--- a/sdk/resourcemanager/docs/MIGRATION_GUIDE.md
+++ b/sdk/resourcemanager/docs/MIGRATION_GUIDE.md
@@ -11,6 +11,7 @@ For users new to the Java SDK for resource management libraries, please see the
 * [Updated Maven depedencies](#updated-maven-dependencies)
 * [General Changes](#general-changes)
   * [Authentication](#authentication)
+  * [AzureResourceManager Class](#azureresourcemanager-class)
   * [Customized Policy](#customized-policy)
   * [Custom HTTP Client](#custom-http-client)
   * [Error Handling](#error-handling)
@@ -73,6 +74,10 @@ Azure azure = Azure.authenticate(new File("my.azureauth")).withDefaultSubscripti
 
 For detailed information on the benefits of using the new authentication classes, please refer to [this page](https://github.com/Azure/azure-sdk-for-java/blob/master/sdk/resourcemanager/docs/AUTH.md)
 
+## AzureResourceManager Class
+
+The `Azure` class has been renamed to `AzureResourceManager`.
+
 ## Customized Policy
 
 Because of adopting Azure Core which is a shared library across all Azure SDKs, there is also a minor change regarding how customized policy in configured.