Skip to content

docs: backfill CHANGELOG entries for v11 breaking changes + GlobalTool→Cli migration guide#225

Merged
ChrisonSimtian merged 1 commit into
mainfrom
docs/changelog-v11-cleanup-and-migration
May 27, 2026
Merged

docs: backfill CHANGELOG entries for v11 breaking changes + GlobalTool→Cli migration guide#225
ChrisonSimtian merged 1 commit into
mainfrom
docs/changelog-v11-cleanup-and-migration

Conversation

@ChrisonSimtian

Copy link
Copy Markdown
Collaborator

Why

Two follow-ups noted in #220's body but not done in that PR — closing them out so the v11 record is complete.

What's in this PR

`CHANGELOG.md` — three new entries under `[Unreleased] — 11.0`, most-recent first:

`docs/migration/from-globaltool-to-cli.md` — new focused migration guide covering:

  • The three consumer scenarios (global install, local `dotnet-tools.json` manifest, thin/fat bootstrappers, direct `dotnet fallout` in CI).
  • Affected-versions table — `Fallout.GlobalTool` frozen at `10.3.40` (now unlisted), `Fallout.Cli` active at `11.0.x`, the `10.3.41-47` `Fallout.Cli` range also unlisted.
  • Why-the-rename context + "stuck on 10.3.40" path.

Modelled on the existing `docs/migration/from-nuke.md`.

Test plan

  • CI green (`docs/**` + `CHANGELOG.md` are both in `paths-ignore` so this should fire the docs-noop workflow only).
  • Falloutdocs picks up the new migration page on next deploy (24h schedule or manual dispatch).

…l→Cli migration guide

Closes the two follow-ups noted in #220's PR body — the v11 record now
covers every breaking change that shipped under 10.3.x and were
catalysed by the semver-policy fix.

CHANGELOG.md — three new entries under [Unreleased] — 11.0, most-recent
first:
  - #214 AES-GCM v2 secret format
  - #206 Fallout.GlobalTool → Fallout.Cli package rename
  - #204 thin shims + dotnet-tools manifest + GitHubActions generator
        regen (PR-B of #203)

docs/migration/from-globaltool-to-cli.md — focused migration guide
covering the three consumer scenarios (global install, local manifest,
shims) plus the affected-versions table noting both the renamed
Fallout.GlobalTool freeze at 10.3.40 and the 10.3.41-47 Fallout.Cli
unlist done via tools/Unlist-NugetPackage.ps1.
@ChrisonSimtian
ChrisonSimtian merged commit 647ea49 into main May 27, 2026
1 check passed
@ChrisonSimtian
ChrisonSimtian deleted the docs/changelog-v11-cleanup-and-migration branch May 27, 2026 10:15
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