Skip to content

docs(changelog): the section describes one rollout state again - #11218

Merged
MarkusNeusinger merged 2 commits into
mainfrom
docs/changelog-rollout-state
Sep 3, 2026
Merged

docs(changelog): the section describes one rollout state again#11218
MarkusNeusinger merged 2 commits into
mainfrom
docs/changelog-rollout-state

Conversation

@MarkusNeusinger

Copy link
Copy Markdown
Owner

One line of CHANGELOG.md, so the [Unreleased] section describes one rollout state instead of two.

#11207's frontend entry said:

…then update-traffic to exactly that revision (the chains are not identical — this one pushes :latest only after the promotion, where the API still pushes it alongside the deploy).

#11212 is what changed that, so the sentence became false the moment it merged. Now:

…to exactly that revision (the chains were not identical at the time — this one pushed :latest only after the promotion, where the API still pushed it alongside the deploy; the API caught up in #11212).

Past tense, and the closing PR named rather than a position: the release cut folds fragments in above the existing bullets, so "the entry above" would be wrong today and right after the cut, while #11212 is true in both.

Why skip-changelog rather than a fragment

This corrects an existing entry; it is not a change worth a release-notes line of its own. And it needs the label, because the fragment gate compares bullet sets — an edited bullet is indistinguishable from an added one. Measured rather than assumed, when this same edit first rode along in #11212:

error: CHANGELOG.md [Unreleased] gained a bullet — it belongs in a fragment:
- **The frontend deploys through a candidate revision instead of straigh…

That is the reason it was taken back out of #11212 and moved here.

The skip-changelog label did not exist in this repository — #11215 documented it as the escape hatch without creating it — so it was created for this PR (grey, "No changelog fragment needed: this PR changes nothing worth a release-notes line"). The gate's own if: condition now has something to match.

Noted for later, not built here: the gate could tell an added bullet from a changed one by treating the bold title as the bullet's identity, which would let a correction like this pass without a label. That is a sibling-pair change for both repos, deliberately out of scope tonight.

🤖 Generated with Claude Code

https://claude.ai/code/session_01UEScQMZFvxxNNyNJYryfa3

MarkusNeusinger and others added 2 commits September 4, 2026 00:04
#11207's frontend entry said "the chains are not identical — this one pushes
`:latest` only after the promotion, where the API still pushes it alongside the
deploy". #11212 is what changed that, so the sentence became false the moment it
merged, and the section described two rollout states at once.

Past tense, with the PR that closed the gap named rather than a position: the
fragments fold in ABOVE the existing bullets at the release cut, so "the entry
above" would be wrong now and right later, while "#11212" is true in both.

Labelled skip-changelog: this is a correction to an existing entry, not a change
worth its own line. It needs the label because the fragment gate compares bullet
SETS, so an edited bullet is indistinguishable from an added one — measured, not
assumed (`tools.changelog check` answered "[Unreleased] gained a bullet" when
this same edit rode along in #11212).

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01UEScQMZFvxxNNyNJYryfa3
Copilot AI balanced review requested due to automatic review settings September 3, 2026 22:05
@MarkusNeusinger MarkusNeusinger added the skip-changelog No changelog fragment needed: this PR changes nothing worth a release-notes line label Sep 3, 2026

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.

🟢 Approval recommended

The documentation-only correction accurately reflects the merged deployment change.

Pull request overview

Updates the unreleased changelog to remain accurate after #11212 aligned the API deployment flow with the frontend.

Changes:

  • Recasts the historical difference in past tense and records when the API caught up.
File summaries
File Description
CHANGELOG.md Corrects the candidate-rollout entry.
Review details
  • Files reviewed: 1/1 changed files
  • Comments generated: 0
  • Review effort level: Balanced

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

@MarkusNeusinger
MarkusNeusinger merged commit 908e65a into main Sep 3, 2026
12 of 13 checks passed
@MarkusNeusinger
MarkusNeusinger deleted the docs/changelog-rollout-state branch September 3, 2026 22:08
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

skip-changelog No changelog fragment needed: this PR changes nothing worth a release-notes line

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants