Add Bootstrap 4 to 5 section to the migration guide#114
Merged
Conversation
Document what the 6.0.0 Bootstrap 5 lift means for existing wikis: lockstep requirement bumps, the jumbotron rebuild on utility classes, emitted class renames that break custom CSS, the data-bs-* attribute rename for hand-written Bootstrap HTML in templates, component initialization moving to the native Bootstrap API, SCSS variable review, and stale Bootstrap 4 markup in the parser cache after the upgrade. Scope the existing content to a 1.x-to-4.0 section, link the guide from the 6.0.0 release notes, and supply the missing FontAwesome link definition. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
kghbln
marked this pull request as draft
July 16, 2026 18:45
migration-guide-bs5.md covers Bootstrap 4 to 5 (BootstrapComponents 6.0), migration-guide-bs4.md covers Bootstrap 3 to 4 (BootstrapComponents ~4.0), and migration-guide.md remains as an index so existing links keep resolving. Point the README and the release-notes references at the split guides, and stub the 6.0.1 release notes to carry the guide, since 6.0.0 shipped without it. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
In running text the extension is called Bootstrap Components, matching the README title and the extension description; identifiers such as the release-notes headings keep the compact form. Version references in the README and the migration-guide index use tilde ranges: ~6.0 for the Bootstrap 5 era, and ~4.0 and ~5.0 for the Bootstrap 4 era, which spans both release lines. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
kghbln
marked this pull request as ready for review
July 16, 2026 19:04
Collaborator
Author
|
@malberts, I added a migration guide from BS4 to BS5. I also bumped the version to 6.0.1. Hopefully the information compiled is correct. Probably your current pull should also land in 6.0.1. In this case, you will need to merge this first, and then yours with changes to the release notes. |
This was referenced Jul 16, 2026
Collaborator
|
High level seems fine. We can always tweak and add more notes as people run into migration issues. |
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.
Document what the 6.0.0 Bootstrap 5 lift means for existing wikis: lockstep requirement bumps, the jumbotron rebuild on utility classes, emitted class renames that break custom CSS, the data-bs-* attribute rename for hand-written Bootstrap HTML in templates, component initialization moving to the native Bootstrap API, SCSS variable review, and stale Bootstrap 4 markup in the parser cache after the upgrade.
Scope the existing content to a 1.x-to-4.0 section, link the guide from the 6.0.0 release notes, and supply the missing FontAwesome link definition.