Skip to content

docs(plugins): add v3 to v4 migration guide#2074

Open
FaithKovi wants to merge 8 commits intohelm:mainfrom
FaithKovi:docs/plugins-migration-guide
Open

docs(plugins): add v3 to v4 migration guide#2074
FaithKovi wants to merge 8 commits intohelm:mainfrom
FaithKovi:docs/plugins-migration-guide

Conversation

@FaithKovi
Copy link
Copy Markdown
Contributor

What this PR does

Adds docs/plugins/migrate.md covering schema changes, subprocess
quick-migration, Wasm migration, and a worked example.

Which issue(s) this PR fixes

Partial fix for #1889

Tip: Need more validation for the examples I created

Signed-off-by: FaithKovi <faithkovivera@gmail.com>
Copy link
Copy Markdown
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

Adds a Helm 3 → Helm 4 plugin migration guide to the new Plugins docs section, supporting issue #1889’s goal of documenting the Helm 4 Wasm/typed plugin system.

Changes:

  • Introduces docs/plugins/migrate.md describing the new plugin.yaml schema (apiVersion, type, runtime, nested config).
  • Documents two migration paths (subprocess quick-migration vs Wasm/Extism) with worked examples.
  • Adds guidance on signing/verification and compatibility expectations.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread docs/plugins/migrate.md Outdated
Comment thread docs/plugins/migrate.md Outdated
Comment thread docs/plugins/migrate.md Outdated
Comment on lines +269 to +272
- [Plugins Overview](/docs/plugins/overview) — full `plugin.yaml`
specification
- [Developing Plugins](/docs/plugins/developer/) — tutorials for
building CLI, Getter, and Postrenderer plugins
Copy link

Copilot AI Apr 17, 2026

Choose a reason for hiding this comment

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

These further-reading links also use the /docs/... prefix, but the rest of the docs link plugin pages under /plugins/... (e.g. /plugins/overview.md, /plugins/developer/index.mdx). As written, these likely won’t resolve; please update them to the canonical routes used elsewhere.

Copilot uses AI. Check for mistakes.
Comment thread docs/plugins/migrate.md Outdated
Comment thread docs/plugins/migrate.md Outdated
Comment thread docs/plugins/migrate.md Outdated
Comment thread docs/plugins/migrate.md
FaithKovi and others added 7 commits April 21, 2026 17:03
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Signed-off-by: Faith Kovi <55793103+FaithKovi@users.noreply.github.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Signed-off-by: Faith Kovi <55793103+FaithKovi@users.noreply.github.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Signed-off-by: Faith Kovi <55793103+FaithKovi@users.noreply.github.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Signed-off-by: Faith Kovi <55793103+FaithKovi@users.noreply.github.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Signed-off-by: Faith Kovi <55793103+FaithKovi@users.noreply.github.com>
Signed-off-by: FaithKovi <faithkovivera@gmail.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants