WIP 📖 Revamp migrations guides to reflect current tooling and options #5233
+766
−1,806
Conversation
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
Contributor
|
[APPROVALNOTIFIER] This PR is APPROVED This pull-request has been approved by: camilamacedo86 The full list of commands accepted by this bot can be found here. The pull request process is described here
Needs approval from an approver in each of these files:
Approvers can indicate their approval by writing |
k8s-ci-robot
added
cncf-cla: yes
k8s-ci-robot
added
the
size/XXL
camilamacedo86
force-pushed
the
fix-migration
branch
from
c745375 to
7d7e392
Compare
Copilot finished reviewing on behalf of
camilamacedo86
November 17, 2025 00:27
There was a problem hiding this comment.
Pull Request Overview
This PR modernizes the migration documentation by consolidating outdated version-specific migration guides into a single, streamlined document focused on current migration tooling. The changes remove legacy migration guides for v1, v2, and v3 transitions and introduce clear guidance on four migration approaches: automated GitHub Actions updates, local alpha update command, alpha generate for re-scaffolding, and fully manual migration.
Key changes:
- Rewrites
migrations.mdto present modern migration workflows (AutoUpdate plugin, alpha update, alpha generate, manual) - Removes 10+ legacy migration guide files (v1vsv2, v2vsv3, v3vsv4, and related manual migration guides)
- Updates SUMMARY.md to remove navigation entries for deleted legacy guides
- Adds guidance on the PROJECT file's role in automated migrations
Reviewed Changes
Copilot reviewed 12 out of 12 changed files in this pull request and generated 2 comments.
Show a summary per file
| File | Description |
|---|---|
| docs/book/src/migrations.md | Complete rewrite focusing on current migration tooling and workflows with four distinct approaches |
| docs/book/src/SUMMARY.md | Removes navigation entries for legacy migration guides |
| docs/book/src/migration/v3vsv4.md | Deleted legacy v3 to v4 migration comparison |
| docs/book/src/migration/v3-plugins.md | Deleted legacy v3 plugins introduction |
| docs/book/src/migration/multi-group.md | Deleted legacy single-to-multi-group migration guide |
| docs/book/src/migration/migration_guide_gov3_to_gov4.md | Deleted step-by-step v3 to v4 migration guide |
| docs/book/src/migration/manually_migration_guide_gov3_to_gov4.md | Deleted manual v3 to v4 migration guide |
| docs/book/src/migration/legacy/v2vsv3.md | Deleted v2 to v3 comparison |
| docs/book/src/migration/legacy/v1vsv2.md | Deleted v1 to v2 comparison |
| docs/book/src/migration/legacy/migration_guide_v2tov3.md | Deleted v2 to v3 migration guide |
| docs/book/src/migration/legacy/migration_guide_v1tov2.md | Deleted v1 to v2 migration guide |
| docs/book/src/migration/legacy/manually_migration_guide_v2_v3.md | Deleted manual v2 to v3 migration guide |
| docs/book/src/migration/legacy.md | Deleted legacy migrations introduction |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
camilamacedo86
force-pushed
the
fix-migration
branch
from
8a17330 to
1697ea4
Compare
Copilot finished reviewing on behalf of
camilamacedo86
November 18, 2025 07:11
There was a problem hiding this comment.
Pull Request Overview
Copilot reviewed 12 out of 12 changed files in this pull request and generated 2 comments.
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
camilamacedo86
force-pushed
the
fix-migration
branch
2 times, most recently
from
ff7c5d9 to
435bbd9
Compare
camilamacedo86
changed the title
k8s-ci-robot
added
the
do-not-merge/work-in-progress
camilamacedo86
force-pushed
the
fix-migration
branch
from
435bbd9 to
d332b2a
Compare
camilamacedo86
changed the title
camilamacedo86
force-pushed
the
fix-migration
branch
4 times, most recently
from
01e0d6f to
f430eee
Compare
camilamacedo86
changed the title
camilamacedo86
force-pushed
the
fix-migration
branch
from
f430eee to
df05a98
Compare
camilamacedo86
force-pushed
the
fix-migration
branch
from
df05a98 to
cb291c5
Compare
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.
Removes outdated information and clarifies when each approach should be used. Adds guidance on the PROJECT file and its role in automation.