Skip to content

feat: build plugin docs as part of package-plugin when docsPath is set#219

Draft
sunker wants to merge 3 commits into
mainfrom
eriksundell/plugin-docs-build-step
Draft

feat: build plugin docs as part of package-plugin when docsPath is set#219
sunker wants to merge 3 commits into
mainfrom
eriksundell/plugin-docs-build-step

Conversation

@sunker
Copy link
Copy Markdown
Contributor

@sunker sunker commented May 4, 2026

What this PR does / why we need it:

Adds a "Build plugin documentation" step to package-plugin that runs npx @grafana/plugin-docs-cli build when docsPath is set in dist/plugin.json. The step generates dist/docs/manifest.json and copies the markdown and images, so multi-page docs ride along in the resulting ZIP and reach the CDN through the existing pipeline.

Plugins without docsPath are unaffected - the bash conditional short-circuits before invoking the CLI.

Which issue(s) this PR fixes:

No issue - part of the multi-page plugin docs initiative.

Special notes for your reviewer:

The build-plugin/action.yml diff currently pins package-plugin@eriksundell/plugin-docs-build-step for testing. Will flip back to @main before merging.

@sunker sunker changed the title Build plugin docs as part of package-plugin when docsPath is set feat: build plugin docs as part of package-plugin when docsPath is set May 4, 2026
@grafana-plugins-platform-bot grafana-plugins-platform-bot Bot moved this from 📬 Triage to 🔬 In review in Grafana Catalog Team May 4, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

Status: 🔬 In review

Development

Successfully merging this pull request may close these issues.

1 participant