Create abp-8-2.md

docs/en/release-info/migration-guides/abp-8-2.md

@@ -0,0 +1,58 @@
+# ABP Version 8.2 Migration Guide
+
+This document is a guide for upgrading ABP v8.x solutions to ABP v8.2. There are some changes in this version that may affect your applications, please read it carefully and apply the necessary changes to your application.
+
+## Updated target frameworks to net8.0 for template projects
+
+`TargetFrameworks` of the following template projects are upgraded to **net8.0**:
+
+* `*.Application.Contracts`
+* `*.Domain.Shared`
+* `*.Domain`
+* `*.MongoDB`
+* `*.HttpApi.Client`
+* `*.Host.Shared` (for module template)
+
+Before this version, all of the projects above were targeting multiple frameworks (**netstandard2.0**, **netstandard2.1** and **net8.0**), with this version, we started to only target **net8.0** for these template projects. Note that, all other shared libraries still target multiple frameworks.
+
+> This change should not affect your pre-existing solutions and you don't need to make any changes in your application. See the PR for more info: https://github.com/abpframework/abp/pull/19565
+## Upgraded AutoMapper to 13.0.1
+
+In this version, **AutoMapper** library version upgraded to 13.0.1. See [the release notes of AutoMapper v13.0.1](https://github.com/AutoMapper/AutoMapper/releases/tag/v13.0.1) for more information.
+
+## Added default padding to `.tab-content` class for Basic Theme
+
+In this version, default padding (padding-top: 1.5rem and padding-bottom: 1.5rem) has been added to the tab-content for the Basic Theme. See [#19475](https://github.com/abpframework/abp/pull/19475) for more information.
+
+## Moved members page directory for Blogging Module
+
+With this version on, ABP Framework allows you to use single blog mode, without needing to define a blog and a prefix. With this change, the following namespace changes were done:
+* `Volo.Blogging.Pages.Blog` -> `Volo.Blogging.Pages.Blogs`
+* `Volo.Blogging.Pages.Members` -> `Volo.Blogging.Pages.Blogs.Members` (members folder)
+
+> If you haven't overridden the pages above, then you don't need to make any additional changes. See [#19418](https://github.com/abpframework/abp/pull/19418) for more information.
+## Removed `FlagIcon` property from the `ILanguageInfo`
+
+The `FlagIcon` property has been removed from the `ILanguageInfo` interface since we removed the flag icon library in the earlier versions from all of our themes and none of them using it now.
+
+If the flag icon has been specified while defining the localization languages, then it should be removed:
+
+```diff
+        Configure<AbpLocalizationOptions>(options =>
+        {
+-           options.Languages.Add(new LanguageInfo("hi", "hi", "Hindi", "in"));
++          options.Languages.Add(new LanguageInfo("hi", "hi", "Hindi"));
+             //...
+        }
+```
+
+## Blazor Full-Stack Web UI
+
+In this version, ABP Framework provides a new UI option called **Blazor Full-Stack WebApp**. We have already created an introduction/migration guide for you to check it: [Migrating to Blazor Web App](abp-8-2-blazor-web-app.md)
+
+> Please read the documentation carefully if you are considering migrating your existing **Blazor** project to **Blazor WebApp**.
+## Session Management Infrastructure
+
+The **Session Management** feature allows you to prevent concurrent login and manage user sessions.
+
+In this version, a new entity called `IdentitySession` has been added to the framework and you should create a new migration and apply it to your database.

docs/en/release-info/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).
 
+- [8.1 to 8.2](abp-8-2.md)
 - [8.0 to 8.1](abp-8-1.md)
 - [7.x to 8.0](abp-8-0.md)
 - [7.3 to 7.4](abp-7-4.md)