Skip to content

Collapse the experimental channel into main; main is the sole prerelease lane (ADR-0008)#407

Merged
ChrisonSimtian merged 1 commit into
mainfrom
chore/collapse-experimental-channel
Jun 18, 2026
Merged

Collapse the experimental channel into main; main is the sole prerelease lane (ADR-0008)#407
ChrisonSimtian merged 1 commit into
mainfrom
chore/collapse-experimental-channel

Conversation

@ChrisonSimtian

Copy link
Copy Markdown
Collaborator

What

Retires the experimental branch and its -alpha GitHub Packages lane. main (-preview) becomes the sole continuous prerelease lane. Steady-state long-lived branches are now main + support/* (+ gh-pages); everything else is a tag or short-lived topic branch.

Decision recorded in ADR-0008, which supersedes the channel-ladder section (§2) of ADR-0004 (its 2026-05-30 amendment). Calendar versioning, the production line, [Experimental], review tiers (ADR-0004 §1, §3–§6), the on-demand cut (ADR-0007), and nuget.org opt-in (ADR-0002) are all unchanged.

Why

The dedicated fast lane didn't earn its keep:

Breaking work now batches on main gated behind [Experimental("FALLOUT0xx")] (or a short-lived topic branch when it can't be gated) — the attribute was always the per-API isolation tool; it now carries the load the branch used to. The production-cut review is the backstop.

Changes

  • CI: delete experimental.yml; preview.yml is the sole continuous publisher. Drop experimental from the ubuntu-latest PR-gate (source: Build.CI.GitHubActions.cs, removed the ExperimentalBranch const). Build verified; generated ubuntu-latest.yml regenerated and in sync.
  • ADR: add ADR-0008; "superseded in part" banner on ADR-0004; index updated.
  • Docs: AGENTS.md, CONTRIBUTING.md, README, branching-and-release.md, release-and-versioning.md, conventions.md, roadmap.md, experimental-apis.md updated to the two-tier (main → release/YYYY) model. The [Experimental] attribute / experimental label are preserved throughout.

Notes

  • The repo-wide ChrisonSimtian → Fallout-build org-repoint (~161 files) is deliberately out of scope — it's a separate follow-up so neither diff is muddied.
  • CHANGELOG.md is deprecated (release notes come from PR labels), so no entry added.

Verification

  • dotnet build build/_build.csproj ✅ (warnings pre-existing)
  • CI workflow regeneration: no drift
  • git grep experimental sweep: only [Experimental] attribute/label refs + settled-history notes remain

@ChrisonSimtian ChrisonSimtian added the target/vCurrent Targets the current version label Jun 18, 2026
@ChrisonSimtian ChrisonSimtian changed the title chore: collapse experimental channel into main (ADR-0008) Collapse the experimental channel into main; main is the sole prerelease lane (ADR-0008) Jun 18, 2026
@ChrisonSimtian
ChrisonSimtian force-pushed the chore/collapse-experimental-channel branch from 23f5caa to b108bb4 Compare June 18, 2026 10:18
…ase lane (ADR-0008)

The `experimental` branch and its `-alpha` GitHub Packages lane are removed;
`main` (`-preview`) becomes the sole continuous prerelease lane. Breaking work
now batches on `main` behind `[Experimental("FALLOUT0xx")]` (or a short-lived
topic branch) instead of on a dedicated branch — the branch ran behind `main`,
carried no unique work, and cost a second publisher + a forward-port obligation
for no realised benefit.

- Delete .github/workflows/experimental.yml; preview.yml is the sole continuous
  publisher.
- Drop `experimental` from the ubuntu-latest PR-gate triggers and the
  Build.CI.GitHubActions.cs source (remove the ExperimentalBranch const).
- Add ADR-0008 (supersedes ADR-0004 §2 channel ladder); banner on ADR-0004.
- Update AGENTS.md, CONTRIBUTING.md, README, and the agent-facing docs to the
  two-tier (main -> release/YYYY) model. The `[Experimental]` attribute and
  label are preserved — the attribute is now the primary isolation tool for
  unstable surface on `main`.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@ChrisonSimtian
ChrisonSimtian force-pushed the chore/collapse-experimental-channel branch from b108bb4 to 5d82f32 Compare June 18, 2026 10:29
@ChrisonSimtian
ChrisonSimtian merged commit 98c2dcb into main Jun 18, 2026
2 checks passed
@ChrisonSimtian
ChrisonSimtian deleted the chore/collapse-experimental-channel branch June 18, 2026 10:30
@ChrisonSimtian ChrisonSimtian removed the target/vCurrent Targets the current version label Jun 18, 2026
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.

1 participant