Decision log of Identity

.vscode/cspell.json

@@ -666,6 +666,13 @@
         "wammsa"
       ]
     },
+    {
+      "filename": "sdk/identity/azure-identity/design-decisions.md",
+      "words": [
+        "nocae",
+        "ROPC"
+      ]
+    },
     {
       "filename": "sdk/identity/azure-identity-broker/tests/*.py",
       "words": [

sdk/identity/azure-identity/README.md

@@ -256,6 +256,8 @@ If you encounter bugs or have suggestions, [open an issue](https://github.com/Az
 
 ## Contributing
 
+For deeper context on why the library is designed the way it is, see the [architecture decision log](https://github.com/Azure/azure-sdk-for-python/blob/main/sdk/identity/azure-identity/design-decisions.md), a chronological record of key design decisions and the reasoning behind them.
+
 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](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'll only need to do this once across all repos using our CLA.