Skip to content

Fix Enterprise release reference inputs - #1315

Merged
danbarr merged 1 commit into
mainfrom
fix/sep-reference-inputs
Nov 4, 2026
Merged

danbarr merged 1 commit into
mainfrom
fix/sep-reference-inputs

Conversation

@danbarr

@danbarr danbarr commented Nov 4, 2026 •

Copy link
Copy Markdown
Collaborator

Description

Enterprise reference publication for v0.26.0 fails because the Helm configuration expects retired gateway operator charts and the former gateway source path. Resolve chart paths and description overrides from the source release's platform chart version, supporting both v0.25.0 and v0.26.0 layouts. Report all missing Helm inputs before generating pages.

Supply the five missing Workspace value descriptions for the published v0.26.0 chart through release-specific overrides. Generated references are left to the SEP publication workflow.

Type of change

  • Bug fix

Related issues/PRs

Companion SEP workflow hardening: https://github.com/stacklok/stacklok-enterprise-platform/pull/6235. Merge this PR first: SEP's updated preflight imports the chart resolver and input validator added here.

Validation

  • node --test scripts/upstream-release/generate-helm-reference.test.mjs: 13 tests passed.
  • Focused Prettier and ESLint checks and git diff --check passed.
  • Pinned helm-docs 1.14.2 validated the actual v0.25.0 source tree (10 charts) and v0.26.0 source tree (8 charts).
  • Full v0.26.0 reference sync in an isolated checkout passed, preserving both legacy Helm pages unchanged.
  • Production docs build with the generated v0.26.0 references passed without HTML minifier diagnostics (371 documents).

Submitter checklist

Content and formatting

  • I have reviewed the content for technical accuracy
  • I have reviewed the content for spelling, grammar, and style

Reviewer checklist

Content

  • I have reviewed the content for technical accuracy
  • I have reviewed the content for spelling, grammar, and style

Resolve Helm chart paths and description overrides from the source
release version. Support the gateway layout in v0.26.0 while retaining
the chart mapping for older releases.

Report all missing Helm inputs before generating reference pages.
Copilot AI balanced review requested due to automatic review settings November 4, 2026 17:56
@vercel

vercel Bot commented Nov 4, 2026 •

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
docs-website Ready Ready Preview Nov 4, 2026 5:59pm UTC

Request Review

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

🔵 Needs a closer look

The private SEP sources and companion PR #6235 returned 404, leaving release-specific chart paths, Workspace descriptions, and preflight compatibility with the new exports unverified pending review by someone with SEP access.

No open issues 🎉

What changed in this PR

Fixes Enterprise Helm reference generation by selecting chart inputs from the source release’s platform chart version, supporting both v0.25.0 and v0.26.0 layouts. This provides the resolver and validator needed by the companion publication workflow.

Changes:

  • Adds version-based chart selection and reports all missing or empty Helm inputs before generation.
  • Configures retired chart cutoffs, the updated gateway path, and five Workspace description overrides.
  • Adds tests for release-specific layouts and combined input validation errors.
File Description
scripts/​upstream-release/​generate-helm-reference.test.mjs Tests chart selection across versions and combined missing-input reporting.
scripts/​upstream-release/​generate-helm-reference.mjs Resolves release-specific charts and validates inputs before generation.
.github/​upstream-projects.yaml Defines chart version rules, gateway paths, and Workspace descriptions.

Review effort: Balanced

@danbarr
danbarr merged commit 49010a8 into main Nov 4, 2026
8 checks passed
@danbarr
danbarr deleted the fix/sep-reference-inputs branch November 4, 2026 18:08

This branch was successfully deployed

1 active deployment
Preview — 7d4bb748 Deployed Nov 4, 2026 by vercel[bot]
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.

3 participants