Skip to content

Add v4 migration rehearsal tutorial#79

Merged
nscuro merged 1 commit into
mainfrom
v4-migration-tutorial
May 15, 2026
Merged

Add v4 migration rehearsal tutorial#79
nscuro merged 1 commit into
mainfrom
v4-migration-tutorial

Conversation

@nscuro
Copy link
Copy Markdown
Member

@nscuro nscuro commented May 15, 2026

To make it easier to v4 users to test with a local stack and provide feedback for the migration procedure.

Copilot AI review requested due to automatic review settings May 15, 2026 11:58
@nscuro nscuro added the enhancement New feature or request label May 15, 2026
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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.

Comment thread docs/tutorials/rehearsing-the-v4-migration.md Outdated
Comment thread docs/tutorials/rehearsing-the-v4-migration.md
@nscuro nscuro force-pushed the v4-migration-tutorial branch from c6a6eb4 to ca8d725 Compare May 15, 2026 12:05
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>
@nscuro nscuro force-pushed the v4-migration-tutorial branch from ca8d725 to 76fa634 Compare May 15, 2026 12:10
@nscuro nscuro merged commit 7042467 into main May 15, 2026
5 checks passed
@nscuro nscuro deleted the v4-migration-tutorial branch May 15, 2026 12:13
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

enhancement New feature or request

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants