Skip to content

docs(menu): consumer migration guide audit (no net change) - #6819

Closed
Rajdeepc wants to merge 3 commits into
rajdeep/menu-migrationfrom
rajdeepchandra/docs-menu-consumer-migration-guide
Closed

Rajdeepc wants to merge 3 commits into
rajdeep/menu-migrationfrom
rajdeepchandra/docs-menu-consumer-migration-guide

Conversation

@Rajdeepc

@Rajdeepc Rajdeepc commented Sep 30, 2026 •

Copy link
Copy Markdown
Contributor

Description

No net change. This branch currently carries no diff against rajdeep/menu-migration.

It was opened to close a suspected gap in the swc-menu consumer migration guide (submenus). That was wrong: the migration plan moves submenus into swc-menu-item's own shadow tree (B3), so they belong to the menu-item follow-up, and the guide's intro already scopes them out by noting sp-menu-item, sp-menu-group, and sp-menu-divider have not migrated. The addition was reverted in 3f773f1.

Motivation and context

Jira: [Menu] Establish component consumer migration guide.

The guide already exists at 2nd-gen/packages/swc/components/menu/migration-guide.mdx (added in #6762) and was audited against the migration plan's Must ship / Additive / Deferred / Disposition tables. No gaps remain in scope for the menu host. Submenus, menu-item, and menu-group are follow-ups.

Path note: the ticket asks for migration.md. The guide is migration-guide.mdx, matching all 26 migrated components and .ai/skills/consumer-migration-guide/SKILL.md; a .md wouldn't render as a Storybook page.

Held open as a placeholder rather than closed.

🤖 Generated with Claude Code

Rajdeep Chandra and others added 2 commits September 30, 2026 18:29
Submenus (B3 in the migration plan) are deferred and have not shipped in
2nd-gen, but the guide never mentioned them. A consumer migrating a menu
that uses submenus would have followed the guide to completion and only
then discovered the submenus were gone, along with their
sp-menu-submenu-opened / sp-menu-submenu-closed listeners and any
handleSubmenuOpened() / handleSubmenuClosed() calls.

Adds submenus to the Removed table alongside the other unshipped
features, calls the gap out up front so it is visible before any work
starts, and adds the corresponding checklist items.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
The submenu warning was added as a second paragraph under the H1, but
the consumer-migration-guide format is an H1 followed by exactly one
sentence, and badge, popover, and tooltip all follow it. Fold the
unshipped-feature caveat into the existing sentence instead.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
@Rajdeepc
Rajdeepc requested a review from a team as a code owner September 30, 2026 16:12
@changeset-bot

changeset-bot Bot commented Sep 30, 2026 •

Copy link
Copy Markdown

⚠️ No Changeset found

Latest commit: 3f773f1

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

@Rajdeepc Rajdeepc added ready-for-review Documentation Component:Menu Status:Ready for review PR ready for review or re-review. gen2 These issues or PRs map to our 2nd generation work to modernizing infrastructure. and removed ready-for-review labels Sep 30, 2026
@Rajdeepc Rajdeepc self-assigned this Sep 30, 2026
@Rajdeepc Rajdeepc changed the title docs(menu): cover submenus in the consumer migration guide docs(menu): consumer migration guide Sep 30, 2026
Submenus belong to the menu-item follow-up, not the menu host guide: the
migration plan moves them into swc-menu-item's own shadow tree (B3), and
the guide's intro already scopes them out by noting that sp-menu-item,
sp-menu-group, and sp-menu-divider have not migrated. The added row
documented something the guide already covered, in the wrong guide.

Restores migration-guide.mdx to its state from #6762.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
@Rajdeepc
Rajdeepc marked this pull request as draft September 30, 2026 16:19
@Rajdeepc Rajdeepc changed the title docs(menu): consumer migration guide docs(menu): consumer migration guide audit (no net change) Sep 30, 2026
@Rajdeepc Rajdeepc closed this Sep 30, 2026
@github-actions

Copy link
Copy Markdown
Contributor

📚 Branch Preview Links

🔍 Gen1 Visual Regression Test Results

When a visual regression test fails (or has previously failed while working on this branch), its results can be found in the following URLs:

Deployed to Azure Blob Storage: pr-6819

If the changes are expected, update the current_golden_images_cache hash in the circleci config to accept the new images. Instructions are included in that file.
If the changes are unexpected, you can investigate the cause of the differences and update the code accordingly.

@Rajdeepc
Rajdeepc deleted the rajdeepchandra/docs-menu-consumer-migration-guide branch September 30, 2026 16:22
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Component:Menu Documentation gen2 These issues or PRs map to our 2nd generation work to modernizing infrastructure. Status:Ready for review PR ready for review or re-review.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant