Merge pull request #16749 from abpframework/EngincanV/migration-guide

Create a migration guide for v7.3

docs/en/Migration-Guides/Abp-7_3.md

@@ -0,0 +1,28 @@
+# ABP Version 7.3 Migration Guide
+
+This document is a guide for upgrading ABP v7.2 solutions to ABP v7.3. There are a few changes in this version that may affect your applications, please read it carefully and apply the necessary changes to your application.
+
+## OpenIddict - Refactoring of `ClaimsPrincipal`
+
+There are some changes that you might need to fix in your code. You can see the following list of the required changes:
+
+* `AbpOpenIddictClaimDestinationsManager` was renamed as `AbpOpenIddictClaimsPrincipalManager`. 
+* Use `AbpOpenIddictClaimsPrincipalManager.HandleAsync` instead of  `AbpOpenIddictClaimDestinationsManager.SetAsync`, which is removed.
+* `AbpDefaultOpenIddictClaimDestinationsProvider` was renamed as `AbpDefaultOpenIddictClaimsPrincipalHandler`.
+* `IAbpOpenIddictClaimDestinationsProvider` was renamed as `IAbpOpenIddictClaimsPrincipalHandler`.
+* Use `IAbpOpenIddictClaimsPrincipalHandler.HandleAsync` instead of  `IAbpOpenIddictClaimDestinationsProvider.SetAsync`, which is removed.
+* `AbpOpenIddictClaimDestinationsOptions` was renamed as `AbpOpenIddictClaimsPrincipalOptions`.
+
+Please check [this PR](https://github.com/abpframework/abp/pull/16537) if you encounter any problems related to OpenIddict Module.
+
+## Nonce attribute support for Content Security Policy (CSP)
+
+ABP Framework supports adding unique value to nonce attribute for script tags which can be used by Content Security Policy to determine whether or not a given fetch will be allowed to proceed for a given element. In other words, it provides a mechanism to execute only correct script tags with the correct nonce value. 
+
+> See the [Security Headers](../UI/AspNetCore/Security-Headers.md) documentation for more information.
+
+This feature comes with a small restriction. If you use any C# code used inside the script tag, it may cause errors (Because a new `NonceScriptTagHelper` has been added, and it replaces script tags in the HTML contents). 
+
+For example, `<script @string.Empty></script>` will no longer work. However, you can use the C# code for an attribute of script tag, for example, `<script src="@string.Empty"></script>` is completely valid and won't cause any problem.
+
+> Note: You should not use any C# code used inside the script tag, even if you don't use this feature. Because it might cause errors.

docs/en/Migration-Guides/Index.md

@@ -2,6 +2,7 @@
 
 The following documents explain how to migrate your existing ABP applications. We write migration documents only if you need to take an action while upgrading your solution. Otherwise, you can easily upgrade your solution using the [abp update command](../Upgrading.md).
 
+- [7.2 to 7.3](Abp-7_3.md)
 - [7.1 to 7.2](Abp-7_2.md)
 - [7.0 to 7.1](Abp-7_1.md)
 - [6.0 to 7.0](Abp-7_0.md)