docs: add missing v8 to v9 migration guides - #36598
Open
Paolo Aliprandi (paolo-aliprandi) wants to merge 17 commits into
Open
docs: add missing v8 to v9 migration guides#36598Paolo Aliprandi (paolo-aliprandi) wants to merge 17 commits into
Paolo Aliprandi (paolo-aliprandi) wants to merge 17 commits into
Conversation
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Copilot-Session: 9faba520-fc05-4d3f-8ac5-e0146fdd09db
📊 Bundle size report✅ No changes found |
|
Pull request demo site: URL |
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Copilot-Session: 9faba520-fc05-4d3f-8ac5-e0146fdd09db
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Copilot-Session: 9faba520-fc05-4d3f-8ac5-e0146fdd09db
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Copilot-Session: 9faba520-fc05-4d3f-8ac5-e0146fdd09db
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Copilot-Session: 9faba520-fc05-4d3f-8ac5-e0146fdd09db
Correct source-backed API details across the existing v8 migration guides and expand validation to cover every guide. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Contributor
Author
|
Reviewed the existing v8 → v9 migration documentation for consistency with the new guides:
|
Fold source-verified Drawer/Popover targeting, dismissal, focus, positioning, and unsupported-behavior guidance into the concise guides. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Paolo Aliprandi (paolo-aliprandi)
marked this pull request as ready for review
August 21, 2026 14:35
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Copilot-Session: 39bc09e0-178f-4cdd-ad81-dbae05242afc
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Copilot-Session: 39bc09e0-178f-4cdd-ad81-dbae05242afc
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Copilot-Session: 39bc09e0-178f-4cdd-ad81-dbae05242afc
Added source-verified component behavior and accessibility edge cases to strengthen the v8 migration guidance. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Copilot-Session: 39bc09e0-178f-4cdd-ad81-dbae05242afc
Contributor
Author
Documentation-only v8 → v9 migration verificationI completed the sealed migration verification pass for the expanded component Result
Final scenario matrix
The remaining
These are agent application misses, not missing or incorrect migration Corrective iteration ledger
Source-verified guide corrections
The structural documentation suite remains green: 139/139 tests, with |
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Copilot-Session: 39bc09e0-178f-4cdd-ad81-dbae05242afc
Contributor
Author
Documentation-only migration verification: 53/53 focused guidesIsolation contract. Each focused verification used only the original v8 source and one guide. Network, MCP, external paths, dependency source/types, subagents, and ambient skills were blocked; build and lint were allowed. Summary. 53/53 launcher/build/lint/isolation checks passed. The latest hidden checklist was 50/53 PASS or VALID_VARIANT, with exactly three Corrected guide findings and clean reruns. Dialog now documents external-trigger focus restoration; Image now documents There were 139/139 structural tests, a clean git diff check, the prior 14/14 integration matrix, and 67 total scenarios. Commit:
|
Paolo Aliprandi (paolo-aliprandi)
requested a review
from Dmytro Kirpa (dmytrokirpa)
August 27, 2026 14:14
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Copilot-Session: 39bc09e0-178f-4cdd-ad81-dbae05242afc
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Copilot-Session: 39bc09e0-178f-4cdd-ad81-dbae05242afc
Sync the final source-verified migration guidance from the 53-component benchmark, including responsive overflow, focus, navigation, selection, and theming corrections. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Copilot-Session: 39bc09e0-178f-4cdd-ad81-dbae05242afc
Contributor
Author
Final documentation sync from the focused benchmarkSynced the finalized documentation corrections from office-shared/fluent-genui-benchmark#133 at benchmark head The update applies the final source-verified guidance across 13 documentation files, including component mapping, Calendar, Charts, CommandBar, DetailsList, Focus, GroupedList, Nav, Overflow, SwatchPicker, Tabs, Theme, and troubleshooting. The final Overflow correction preserves natural visible layout when no finite host constraint exists and applies vertical clipping only when an ancestor supplies one. The focused benchmark conclusion remains: 53/53 guides launched, built, linted, and passed isolation; zero remaining The committed Fluent UI files pass the dedicated migration documentation suite: 139/139 tests, with |
Contributor
Author
Complete 53-component benchmark resultsCopied from office-shared/fluent-genui-benchmark#133. The first table is the complete 53 components × 5 trials = 265 isolated-run baseline. The optimization table that follows contains five fresh trials for the 11 guides revised from that baseline and supersedes their baseline means. The remaining 42 components required no documentation revision, so their baseline results remain final. Completed 53 components × 5 fresh trials = 265 independently generated, judged, and oracle-scored reports.
Docs-only v8 → v9 migration documentation optimization — final reportThe optimization loop is complete. I used the 53-component × 5-trial baseline to identify weak components, revised only source-backed migration guidance, and ran five fresh isolated trials per actionable component after the revisions. Aggregate result
All final values below are five-trial means:
What changed
Documentation commits:
Stopping decisions and caveats
All producer runs were isolated to one benchmark, all final scored reports contain exactly one benchmark, and the complete run artifacts remain under |
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
1 participant
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.
Summary
Adds and validates comprehensive v8-to-v9 migration documentation for mapped Fluent UI components.
Guide coverage
Breadcrumb, Calendar, Callout, CommandBar, DatePicker, DetailsList, Dialog, Dropdown/Combobox, FocusZone/FocusTrapZone, Icon, Link, List, MessageBar, Nav, OverflowSet, Panel, Persona, ProgressIndicator, Rating, SearchBox, Shimmer, SwatchColorPicker, TagPicker/PeoplePicker, TeachingBubble/Coachmark, Text, TimePicker, Toggle, and Tooltip.
ComboBox is covered by the shared Dropdown/Combobox guide. Stack and Stack.Item are covered by the existing Flex guides, with
StackShimandStackItemShimdocumented as temporary migration bridges.Existing documentation alignment
Validation
git diff --checkReview focus
This remains a draft for component-owner review, especially for behavioral edge cases where v8 has no one-to-one v9 prop mapping and for compatibility-component guidance.
Current working directory: /Users/paoloaliprandi/Desktop/fluent-genui-benchmark