Skip to content

Hide unreleased CDN changelog bundles on the current content source - #3857

Open
cotti wants to merge 1 commit into
feature/bundle-output-conventionfrom
feature/changelog-versions-visibility
Open

Hide unreleased CDN changelog bundles on the current content source#3857
cotti wants to merge 1 commit into
feature/bundle-output-conventionfrom
feature/changelog-versions-visibility

Conversation

@cotti

@cotti cotti commented Aug 13, 2026

Copy link
Copy Markdown
Contributor

Why

Prestage products commit and upload release bundles to S3 weeks before release day, so the CDN holds bundles for versions that are not released yet. Without filtering, those staged bundles would render on production the moment they upload (RFC B1, docs-eng-team#698) — this is the gate that makes the whole Prestage path safe to roll out.

What

CDN-mode {changelog} rendering now checks each bundle's target version against the product's versioning system in versions.yml:

  • Builds publishing the current content source (production) hide bundles targeting versions newer than the current release, with a hint diagnostic.
  • Builds publishing next (staging) keep them visible — pre-release review works as the RFC prescribes — and the versions.yml bump on release day flips them live on production automatically.
  • Local/isolated builds (no content source) and products without a semver versioning system (date-based targets like cloud-serverless) are never filtered.

To make the decision possible at render time, BuildContext now carries the assembler's ContentSource (set from the publish environment; null for isolated builds). Directive docs gained an "Unreleased-version visibility" section.

Stack: 4/5.

Prestage products upload release bundles to S3 weeks before release day
(RFC B1, docs-eng-team#698). CDN-mode {changelog} rendering now checks a
bundle's target version against the product's versioning system: builds
publishing the 'current' content source (production) hide targets newer
than the current release, while 'next' (staging) keeps them visible for
pre-release review — the versions.yml bump on release day flips them
live automatically. BuildContext learns the assembler's content source;
isolated/local builds and versionless products are never filtered.

Co-Authored-By: Claude Sonnet 4.6 (1M context) <noreply@anthropic.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