Skip to content

[2027-01-rc] Shorten the addressLineComponents doc comment - #4767

Draft
rcaplanshopify wants to merge 5 commits into
2027-01-rcfrom
address-line-components-short-jsdoc-2027-01-rc
Draft

rcaplanshopify wants to merge 5 commits into
2027-01-rcfrom
address-line-components-short-jsdoc-2027-01-rc

Conversation

@rcaplanshopify

@rcaplanshopify rcaplanshopify commented Oct 22, 2026 •

Copy link
Copy Markdown
Contributor

What

Shortens the MailingAddress.addressLineComponents doc comment in src/surfaces/checkout/api/shared.ts and regenerates the checkout docs data. The write-semantics paragraph is replaced with a link to the Regional address components guide.

Stacked on #4763 so the regen uses @shopify/generate-docs 1.3.0; the first three commits are #4763's and drop out once it merges.

Why

Docs review feedback: the type description on the Addresses API page was a dense block that duplicated the guide. The reference now gives the one-line definition and points to the guide for the rest.

Verification

No changeset: doc-comment and generated-output change only.

Checklist

  • I have 🎩'd these changes
  • I have updated relevant documentation

Forward-port of #4766

rcaplanshopify and others added 5 commits October 21, 2026 13:50
Co-authored-by: claude-fable-5-1 <noreply@anthropic.com>
Co-authored-by: claude-fable-5-1 <noreply@anthropic.com>
Co-authored-by: claude-fable-5-1 <noreply@anthropic.com>
Replace the write-semantics paragraph with a link to the Regional address
components guide, per docs review feedback.

Co-authored-by: claude-fable-5-1 <noreply@anthropic.com>
Co-authored-by: claude-fable-5-1 <noreply@anthropic.com>

This branch has not been deployed

No deployments
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.

1 participant