2026-04: Fix doc generation to resolve shopify-dev from World

[vctrchu]

Related to https://github.com/shop/issues-retail/issues/26023

TL;DR

Update doc generation path to resolve shopify-dev from the World monorepo instead of the deprecated standalone repo.

What changed?

• resolveShopifyDevPath now resolves to ~/world/trees/root/src/areas/platforms/shopify-dev
• Removed legacy fallback to ../../../shopify-dev (standalone repo)
• Removed interactive prompt and unused readline import
• Updated build-docs.mjs caller to match new signature (no args)

Why?

shopify-dev has moved into World at //areas/platforms/shopify-dev. The standalone repo is deprecated. Running yarn docs:point-of-sale should copy generated output directly to the World zone.

Note

This PR targets 2026-04-rc. The same change needs to be applied to other active version branches (e.g. 2025-10, 2026-01) since build-doc-shared.mjs and build-docs.mjs are shared across all versions. Cherry-pick or open matching PRs for other branches as needed.

How to test?

Requires //areas/platforms/shopify-dev in your sparse checkout:

tec checkout add //areas/platforms/shopify-dev

Then run yarn docs:point-of-sale 2026-04-rc — generated JSON should appear in ~/world/trees/root/src/areas/platforms/shopify-dev/db/data/docs/templated_apis/pos_ui_extensions/2026-04-rc/.

[github-actions]

🚨🚨🚨 Docs migration in progress 🚨🚨🚨

We are actively migrating UI extension reference docs to MDX in the areas/platforms/shopify-dev zone of the monorepo. This impacts docs for the following surfaces:

• Admin UI extensions
• App Home
• Checkout UI extensions
• Customer account UI extensions
• POS UI extensions

During this migration, please be aware of the following:

.doc.ts files are being deprecated. Changes to .doc.ts files in this repo will not be reflected in the new MDX-based docs. If you need to update docs for a reference that has already been migrated, make your changes directly in the areas/platforms/shopify-dev zone of the monorepo instead.

Doc comments in .ts source files (the comment blocks above types and functions) are also affected. Generating docs from these comments currently requires a newer version of the @shopify/generate-docs library that isn't yet available. Updates to doc comments may not produce the expected output until the migration is complete.

Examples that previously lived in this repo are being moved to the areas/platforms/shopify-dev zone of the monorepo and should be authored there going forward.

What should I do?

• If your PR includes changes to .doc.ts files, doc comments, or examples, please reach out to us in #devtools-proj-templated-refs so we can help ensure your updates are captured correctly.
• If your PR is limited to source code changes (non-docs), you can ignore this notice.

Thanks for your patience while we complete the migration! 🙏

[vctrchu]

• feat(pos): add TypeScript types for pos.app.ready.data background target #4123
• 2026-04: Fix doc generation to resolve shopify-dev from World #4124 👈 (View in Graphite)
• main

This stack of pull requests is managed by Graphite. Learn more about stacking.