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

Create a migration guide for v7.1

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

@@ -0,0 +1,19 @@
+# ABP Version 7.1 Migration Guide
+
+This document is a guide for upgrading ABP v7.0 solutions to ABP v7.1. 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.
+
+## Navigation Menu - `CustomData` type changed to `Dictionary<string, object>`
+
+`ApplicationMenu` and `ApplicationMenuItem` classes' `CustomData` property type has been changed to `Dictionary<string, object>`. So, if you use the optional `CustomData` property of these classes, change it accordingly. See [#15608](https://github.com/abpframework/abp/pull/15608) for more information.
+
+*Old usage:*
+
+```csharp
+var menu = new ApplicationMenu("Home", L["Home"], "/", customData: new MyCustomData()); 
+```
+
+*New usage:*
+
+```csharp
+var menu = new ApplicationMenu("Home", L["Home"], "/").WithCustomData("CustomDataKey", new MyCustomData());
+```

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.0 to 7.1](Abp-7_1.md)
 - [6.0 to 7.0](Abp-7_0.md)
 - [5.3 to 6.0](Abp-6_0.md)
 - [5.2 to 5.3](Abp-5_3.md)