fix(docs): restore operator changelog v4.md and add v4.2 to sidebar#22609
Merged
Conversation
…idebar The v4.1.3 versioned docs had an expanded v4.md changelog (333 lines) that was independently updated but never propagated back to the source docs-operate. When the v4.2.0 snapshot was cut from source, it picked up the old stub content (93 lines) instead. This commit: - Restores the full v4.md changelog content in both the v4.2.0 versioned docs and the source docs-operate (reference/changelog/ path) - Adds v4.2.md to the sidebar and changelog index so it's discoverable - Fixes broken link to high_availability_sequencers → high-availability
AztecBot
added
ci-draft
critesjosh
approved these changes
Apr 17, 2026
Collaborator
Author
|
❌ Failed to cherry-pick to |
AztecBot
pushed a commit
that referenced
this pull request
Apr 17, 2026
… to sidebar (with conflicts) Cherry-pick of #22609 (merge commit cbb09bc) onto v4-next. Applied with -m 1 -Xno-renames. Conflicts + git rename-detection misfires to resolve in next commit: - version-v2.1.11-ignition/reference/changelog/v4.md: conflict (git mapped the v4.2.0/reference/changelog/v4.md patch here because version-v4.2.0/ does not exist on v4-next) - version-v2.1.11-ignition-sidebars.json: auto-merged from version-v4.2.0-sidebars.json — not a real target - version-v4.1.2/operators/reference/changelog/index.md: auto-merged from v4.2.0 — v4.2 does not yet have a versioned folder here - version-v4.1.2/operators/reference/changelog/v4.md: auto-merged link fix from v4.2.0 — v4.1.2 already points at the correct path Legitimate portions: docs-operate/reference/changelog/v4.md restore, docs-operate/operators/reference/changelog/index.md v4.2 entry, sidebars-operate.js v4.2 entry.
3 tasks
critesjosh
added a commit
that referenced
this pull request
Apr 17, 2026
## Summary Backport of #22609 onto `v4-next`. The upstream PR did two things: 1. **Core fix**: restore the full v4.x changelog content (325 lines) in the docs-operate source. The stub had regressed via PR #22581. 2. **v4.2 discoverability**: advertise `v4.2.md` by adding it to the operator changelog index, the `sidebars-operate.js` sidebar, and the `version-v4.2.0/` versioned snapshot. Only (1) applies to `v4-next`. The v4.2.0 versioned folder and `v4.2.md` source file do not exist on this branch yet (PRs #22581 / #22612 have not been backported), so advertising `v4.2.md` would break the Docusaurus build. ## 3-commit structure Per `.claude/claudebox/backport.md`: 1. `cherry-pick: ... (with conflicts)` — raw `git cherry-pick -m 1 -Xno-renames cbb09bc` output. Git's rename detection misrouted the v4.2.0 patches onto `version-v2.1.11-ignition` and `version-v4.1.2`, producing a conflict plus unwanted auto-merges. 2. `fix: resolve cherry-pick conflicts` — restore `version-v2.1.11-ignition/reference/changelog/v4.md` to its pre-cherry-pick state. The conflict was caused by the misdirected rename, not by real content that belongs here. 3. `fix: adapt backport for v4-next (no v4.2.0 version yet)` — revert the remaining rename-misfires, and drop the v4.2 entries from `docs-operate` index.md + `sidebars-operate.js` that would reference the non-existent `v4.2.md`. Keep the HA-guide link fix (`high_availability_sequencers` → `high-availability.md`), which is valid on v4-next too. ## Net effect ``` docs/docs-operate/reference/changelog/v4.md | 324 ++++++++++++++++++--- .../operators/reference/changelog/v4.md | 2 +- ``` Analysis: https://gist.github.com/AztecBot/8024d49bed623cf741c9fd64f72505b0 ## Test plan - [ ] `yarn build` in `docs/` succeeds (no broken sidebar / broken-link errors). - [ ] `docs/docs-operate/reference/changelog/v4.md` renders with the full v4.x migration content. - [ ] Revisit `docs-operate/operators/reference/changelog/index.md` + `sidebars-operate.js` after #22581 / #22612 are backported to re-add v4.2 entries. ClaudeBox log: https://claudebox.work/s/c59bb40b529f1bc2?run=1
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Fixes a regression from PR #22581 where the operator changelog
reference/changelog/v4.mdin the v4.2.0 versioned docs had old stub content (93 lines) instead of the full expanded changelog (333 lines).Root cause: The v4.1.3 versioned copy of
reference/changelog/v4.mdwas independently updated (commit d44c526) with comprehensive entries for all v4.x breaking changes and new features, but those changes were never propagated back to the sourcedocs-operate/. When v4.2.0 docs were cut from source, they inherited the old stub.Changes:
high_availability_sequencers→high-availabilityTest plan
docs/network_versioned_docs/version-v4.2.0/reference/changelog/v4.mdmatchesoperators/reference/changelog/v4.mdyarn buildin docs/ to confirm no broken linksClaudeBox log: https://claudebox.work/s/62e0b9bc1a1fea36?run=2