Fix broken web-components doc links in admin (2026-07-rc)#4536
Open
sordaz00 wants to merge 1 commit into
Open
Conversation
sordaz00
changed the title
sordaz00
force-pushed
the
fix/app-home-wc-links-2026-07-rc
branch
from
0c6aa24 to
14ebbd4
Compare
sordaz00
changed the title
sordaz00
changed the title
chadwcarlson
approved these changes
Jul 1, 2026
gwyneplaine
approved these changes
Jul 2, 2026
Contributor
Author
Merge activity
|
sordaz00
force-pushed
the
fix/app-home-wc-links-2026-07-rc
branch
from
14ebbd4 to
f8b2882
Compare
mikeygough
approved these changes
Jul 2, 2026
laurkim
approved these changes
Jul 2, 2026
kyledurand
approved these changes
Jul 2, 2026
sordaz00
force-pushed
the
fix/app-home-wc-links-2026-07-rc
branch
from
f8b2882 to
a337812
Compare
Admin component JSDoc linked to the old `using-web-components` slug (both `polaris/` and `app-ui/` prefixes). That slug 301-redirects to the canonical page, and the redirect drops the URL `#fragment`, so links like SpacingKeyword (#scale) and responsive value (#responsive-values) landed at the top of the page instead of the section. Restore the canonical slug everywhere: (polaris|app-ui)/using-web-components -> polaris/using-polaris-web-components Updates the 9 source .d.ts files and the checked-in v2 docs data (app_home, app_home_ui_extension/2026-07-rc, admin_extensions/2026-07-rc). Links-only diff, 201 occurrences. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
sordaz00
force-pushed
the
fix/app-home-wc-links-2026-07-rc
branch
from
a337812 to
a41935c
Compare
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
6 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.
Problem
These links were broken. Admin component JSDoc linked to the old
using-web-componentsslug, which no longer resolves correctly. There were two failure modes, both live on production:/docs/api/polaris/using-web-components#…(most links)/docs/api/app-ui/using-web-components#…#fragment, landing at the top instead of the section/docs/api/polaris/using-polaris-web-components#…So links such as
SpacingKeyword(#scale) and responsive value (#responsive-values) either 404’d outright or dumped the reader at the top of the page instead of the intended section.Fix
Restore the canonical slug everywhere in the admin surface:
Links-only diff (no content/symbol changes). Touches the source
.d.tsfiles and the checked-in v2 docs data.🤖 Generated with Claude Code
Part of a set fixing this across all affected versions: #4538 (2025-10), #4539 (2026-01), #4537 (2026-04), #4536 (2026-07-rc).