From 4a1b7f228db97c572523ff7e24dc8383db9b8fc6 Mon Sep 17 00:00:00 2001 From: Peter Macdonald Date: Tue, 31 Mar 2026 13:30:00 +0200 Subject: [PATCH] update wording Signed-off-by: Peter Macdonald --- .../skills/plugin-full-frontend-system-migration/SKILL.md | 2 +- .../skills/plugin-new-frontend-system-support/SKILL.md | 2 ++ 2 files changed, 3 insertions(+), 1 deletion(-) diff --git a/docs/.well-known/skills/plugin-full-frontend-system-migration/SKILL.md b/docs/.well-known/skills/plugin-full-frontend-system-migration/SKILL.md index 55d6727732..8f7ee3498b 100644 --- a/docs/.well-known/skills/plugin-full-frontend-system-migration/SKILL.md +++ b/docs/.well-known/skills/plugin-full-frontend-system-migration/SKILL.md @@ -9,7 +9,7 @@ This skill helps fully migrate an existing Backstage plugin from the old fronten This is the preferred approach for internal plugins that are only used in a single app, since there is no need to maintain backward compatibility. It can also be used for published plugins when you're ready to drop old system support entirely. -It is highly recommended to be on Backstage version 1.49.x or above. This can be verified by looking in the `backstage.json` file in the root of the repository. +It is highly recommended to be on Backstage version 1.49.x or above before starting this, although not mandatory, you may face issues with some of the instructions below. This can be verified by looking in the `backstage.json` file in the root of the repository. ## Key Differences from Dual Support diff --git a/docs/.well-known/skills/plugin-new-frontend-system-support/SKILL.md b/docs/.well-known/skills/plugin-new-frontend-system-support/SKILL.md index 2bb0bf4da3..2912215327 100644 --- a/docs/.well-known/skills/plugin-new-frontend-system-support/SKILL.md +++ b/docs/.well-known/skills/plugin-new-frontend-system-support/SKILL.md @@ -9,6 +9,8 @@ This skill helps add new frontend system (NFS) support to an existing Backstage This is the preferred approach for published plugins or plugins that are used by external parties, since it avoids forcing consumers to migrate their app before they are ready. +It is highly recommended to be on Backstage version 1.49.x or above before starting this, although not mandatory, you may face issues with some of the instructions below. This can be verified by looking in the `backstage.json` file in the root of the repository. + ## Key Concepts - **Dual entry point:** The plugin keeps its existing `src/plugin.ts` (old system) and adds a new `src/alpha.tsx` (new system)