Skip to content

docs: Add @volo/ai-management NPM package requirement to ABP 10.2 migration guide#25013

Merged
EngincanV merged 2 commits intorel-10.2from
copilot/update-migration-guide-10-2
Mar 4, 2026
Merged

docs: Add @volo/ai-management NPM package requirement to ABP 10.2 migration guide#25013
EngincanV merged 2 commits intorel-10.2from
copilot/update-migration-guide-10-2

Conversation

Copy link
Contributor

Copilot AI commented Mar 4, 2026

Description

The ABP 10.2 migration guide was missing a required step for MVC UI users of the AI Management Module: adding the new @volo/ai-management NPM package introduced for enhanced markdown rendering on the chat playground.

Changes to docs/en/release-info/migration-guides/abp-10-2.md:

  • Added new Pro section: "Add @volo/ai-management NPM Package for MVC UI" — instructs developers to add the package to package.json and run abp install-libs
  • Updated the Pro section intro to be generic (multiple conditional items now listed)

Developers using MVC UI of the AI Management Module must add to their package.json:

"@volo/ai-management": "10.2.0"

Then run:

abp install-libs

Checklist

  • I fully tested it as developer / designer and created unit / integration tests
  • I documented it (or no need to document or I will create a separate documentation issue)

How to test it?

Verify the rendered migration guide at docs/en/release-info/migration-guides/abp-10-2.md includes the new @volo/ai-management section under Pro.


✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.

Copilot AI changed the title [WIP] Update 10.2 migration guide for AI Management Module docs: Add @volo/ai-management NPM package requirement to ABP 10.2 migration guide Mar 4, 2026
@EngincanV EngincanV self-requested a review March 4, 2026 10:38
@EngincanV EngincanV marked this pull request as ready for review March 4, 2026 10:38
Copilot AI review requested due to automatic review settings March 4, 2026 10:38
@EngincanV EngincanV enabled auto-merge March 4, 2026 10:38
@EngincanV EngincanV merged commit 4f49a81 into rel-10.2 Mar 4, 2026
4 checks passed
@EngincanV EngincanV deleted the copilot/update-migration-guide-10-2 branch March 4, 2026 10:39
Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Updates the ABP 10.2 migration guide to include an additional required step for ABP Commercial (Pro) users who use the AI Management Module’s MVC UI, ensuring client-side assets are installed correctly for the chat playground’s enhanced markdown rendering.

Changes:

  • Updated the Pro section introduction to support multiple conditional migration steps.
  • Added a new Pro subsection instructing MVC UI users to add @volo/ai-management to package.json and run abp install-libs.

Comment on lines +131 to +133
### Add `@volo/ai-management` NPM Package for MVC UI

If you are using the MVC UI of the [AI Management Module](../../modules/ai-management.md), you need to add the `@volo/ai-management` package to your `package.json` file. This package was introduced in ABP v10.2 to support the enhanced markdown rendering on the chat playground.
Copy link

Copilot AI Mar 4, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

For consistency with the module documentation wording (“MVC / Razor Pages UI”), consider using the same phrasing in this heading (and/or the paragraph below) so users can more easily map this step to the relevant UI option.

Suggested change
### Add `@volo/ai-management` NPM Package for MVC UI
If you are using the MVC UI of the [AI Management Module](../../modules/ai-management.md), you need to add the `@volo/ai-management` package to your `package.json` file. This package was introduced in ABP v10.2 to support the enhanced markdown rendering on the chat playground.
### Add `@volo/ai-management` NPM Package for MVC / Razor Pages UI
If you are using the MVC / Razor Pages UI of the [AI Management Module](../../modules/ai-management.md), you need to add the `@volo/ai-management` package to your `package.json` file. This package was introduced in ABP v10.2 to support the enhanced markdown rendering on the chat playground.

Copilot uses AI. Check for mistakes.

### Add `@volo/ai-management` NPM Package for MVC UI

If you are using the MVC UI of the [AI Management Module](../../modules/ai-management.md), you need to add the `@volo/ai-management` package to your `package.json` file. This package was introduced in ABP v10.2 to support the enhanced markdown rendering on the chat playground.
Copy link

Copilot AI Mar 4, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The relative link to the AI Management Module docs appears to be incorrect. This repo has the AI Management docs at docs/en/modules/ai-management/index.md (and other docs, e.g. the ABP 10.1 migration guide, link to ../../modules/ai-management/index.md). Update the link target so it resolves correctly.

Suggested change
If you are using the MVC UI of the [AI Management Module](../../modules/ai-management.md), you need to add the `@volo/ai-management` package to your `package.json` file. This package was introduced in ABP v10.2 to support the enhanced markdown rendering on the chat playground.
If you are using the MVC UI of the [AI Management Module](../../modules/ai-management/index.md), you need to add the `@volo/ai-management` package to your `package.json` file. This package was introduced in ABP v10.2 to support the enhanced markdown rendering on the chat playground.

Copilot uses AI. Check for mistakes.

Add the following line to the `dependencies` section of your `package.json` file:

```json
Copy link

Copilot AI Mar 4, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The fenced block is labeled as json, but the snippet shown ("@volo/ai-management": "10.2.0") isn’t valid JSON on its own. Consider showing it within the dependencies object (or switching the fence to text) to avoid copy/paste confusion.

Suggested change
```json
```text

Copilot uses AI. Check for mistakes.
## Pro

There are no breaking changes on the PRO side. However, if you use the Identity Pro module with Entity Framework Core, you need to make the following update:
There are no breaking changes on the PRO side. However, please check the following sections if they apply to your application.
Copy link

Copilot AI Mar 4, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The intro sentence says “There are no breaking changes on the PRO side” but the sections below describe required updates for some PRO module users. Consider rephrasing to clarify that there are no unconditional breaking changes, but there are conditional actions depending on which PRO modules/UIs you use.

Suggested change
There are no breaking changes on the PRO side. However, please check the following sections if they apply to your application.
There are no unconditional breaking changes on the PRO side, but some module/UI-specific updates may be required. Please review the following sections and apply them if they apply to your application.

Copilot uses AI. Check for mistakes.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants