Skip to content

docs(migration): cover the changes the guide had missed - #712

Merged
mrholek merged 1 commit into
v6-devfrom
docs/migration-guide-gaps-v6
Aug 7, 2026
Merged

docs(migration): cover the changes the guide had missed#712
mrholek merged 1 commit into
v6-devfrom
docs/migration-guide-gaps-v6

Conversation

@mrholek

@mrholek mrholek commented Aug 7, 2026

Copy link
Copy Markdown
Member

I walked every commit on v6-dev since the guide was written and checked it against the guide. Five user-visible changes had no entry, and two entries had gone stale.

Missing

Change PR Why it matters
The *.rtl.css builds are gone #682 The biggest gap by far. 20 files left dist/csscoreui.rtl.css and friends, minified twins, maps, SRI hashes — and nothing said so. Anyone linking coreui.rtl.min.css gets a 404 and no hint that they now drop the .rtl and keep dir="rtl". Verified: no rtl files in dist/css, no rtl scripts in package.json.
Button always exposes aria-pressed #706 Rendered markup changes for every [data-coreui-toggle="button"].
Number Input #694 Mentioned only in passing, inside the entry about the frame it shares with Password Input — never announced as a new component, though number-input.js does not exist in v5 at all.
Multi Select option checkboxes are the form-check surface #660, #661 The indicators stopped being ::before pseudo-elements with their own variable set; the per-indicator look variables went with them (only $combobox-option-indicator-width survives).
list-style-type: "" replaces list-style: none #664 Sweeps nav, navbar, header, sidebar-nav, dropdown, breadcrumb and the list-unstyled mixin.

Stale

  • The select-indicator entry still said "the RTL build still flips the right/left keyword at compile time" — there is no RTL build. It comes from a [dir="rtl"] rule in the same sheet now.
  • The popup-primitive entry claimed "the anchored presentation is unchanged", which stopped being true in feat(popup): fade the panel in, the way Menu already animates #698 when the panel started fading in. It now describes the fade and its two tokens.

Checked and already covered

Browser floors (#697, #667), the picker rewrite and the -dropdown rename (#666, #699), .form-control-group and the per-family frames (#675, #693, #695, #696, #691), the combobox class unification (#656#659), chip roles (#658), the utilities API changes (#684, #685), week/quarter masks (#673), Toast (#707), the promise API (#708), Collapse's toggle (#710) and the reduced-motion gating (#705).

Deliberately not added: pure bug fixes with no migration action — the Sidebar dispose() fix (#687), Modal/Offcanvas focus restore (#663), the upstream EventHandler/Menu port (#662), the OTP autofill fixes (#665, #669) and the build fixes (#692).

docs-build completes with no broken links across 140 pages.

An audit of every v6-dev commit against the guide found five user-visible
changes with no entry, and one entry that had gone stale.

Missing:

- **The `*.rtl.css` builds are gone** (#682). The biggest gap: 20 files left
  `dist/css` and nothing said so. Anyone linking `coreui.rtl.min.css` gets a
  404 with no explanation of what to do instead.
- **Button always exposes `aria-pressed`** (#706).
- **Number Input** (#694) was mentioned only in passing, inside the entry about
  the frame it shares with Password Input, never announced as new.
- **Multi Select option checkboxes are the form-check surface now** (#660,
  #661), which retires the per-indicator look variables.
- **Markers are hidden with `list-style-type: ""`** (#664).

Stale: the select-indicator entry still said "the RTL build flips the
right/left keyword at compile time" — there is no RTL build. And the popup
primitive entry claimed "the anchored presentation is unchanged", which stopped
being true when the panel started fading in (#698).
@coveralls

Copy link
Copy Markdown

Coverage Report for CI Build 31215126696

Coverage decreased (-0.007%) to 92.982%

Details

  • Coverage decreased (-0.007%) from the base build.
  • Patch coverage: No coverable lines changed in this PR.
  • 1 coverage regression across 1 file.

Uncovered Changes

No uncovered changes found.

Coverage Regressions

1 previously-covered line in 1 file lost coverage.

File Lines Losing Coverage Coverage
js/src/navigation.ts 1 64.63%

Coverage Stats

Coverage Status
Relevant Lines: 8675
Covered Lines: 8280
Line Coverage: 95.45%
Relevant Branches: 4819
Covered Branches: 4267
Branch Coverage: 88.55%
Branches in Coverage %: Yes
Coverage Strength: 363.42 hits per line

💛 - Coveralls

@mrholek
mrholek merged commit cdf2534 into v6-dev Aug 7, 2026
9 checks passed
@mrholek
mrholek deleted the docs/migration-guide-gaps-v6 branch August 7, 2026 20:39
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants