Add v4 migration rehearsal tutorial#79
Merged
Merged
Conversation
Contributor
There was a problem hiding this comment.
Pull request overview
Adds a new tutorial to help operators rehearse the v4→v5 migration against a local v5 sandbox stack, and wires it into the documentation site/navigation.
Changes:
- Add a new “Rehearsing the v4 to v5 migration” tutorial and link it from the migration guide and tutorials nav.
- Enable MkDocs Material tab linking to support tabbed snippets in the new tutorial.
- Minor docs housekeeping: update tech stack reference (Flyway), adjust context inventory text, and extend Vale vocabulary.
Reviewed changes
Copilot reviewed 8 out of 9 changed files in this pull request and generated 2 comments.
Show a summary per file
| File | Description |
|---|---|
| mkdocs.yml | Enables content.tabs.link to support linked tabbed content in docs. |
| existing-docs/README.md | Removes prior placeholder README for the existing-docs/ symlink target. |
| existing-docs/.gitkeep | Keeps existing-docs/ tracked as an (otherwise) empty directory. |
| docs/tutorials/rehearsing-the-v4-migration.md | New end-to-end sandbox rehearsal tutorial for v4→v5 migration using the migrator container. |
| docs/tutorials/.pages | Adds the new rehearsal tutorial to the tutorials navigation. |
| docs/guides/administration/migrating-from-v4.md | Links to the new rehearsal tutorial and updates the migrator image name in the alias example. |
| context/source-inventory.md | Removes the “Existing Docs Accuracy” section from the source inventory context doc. |
| context/briefing.md | Updates tech stack wording from Liquibase to Flyway. |
| .vale/styles/config/vocabularies/DependencyTrack/accept.txt | Adds “cutover” to accepted vocabulary. |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
c6a6eb4 to
ca8d725
Compare
To make it easier to v4 users to test with a local stack and provide feedback for the migration procedure. Signed-off-by: nscuro <nscuro@protonmail.com>
ca8d725 to
76fa634
Compare
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
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.
To make it easier to v4 users to test with a local stack and provide feedback for the migration procedure.