docs: refresh onboarding pages for GA launch - #587
Draft
pwillia7 wants to merge 6 commits into
Draft
Conversation
Combine Introduction and Why Use This into one overview, add a Features landing page, and rework Setup, Shopify Setup, and Extending with Agents for the public launch onboarding experience. - index: enterprise-ready framing, agentic development, base template vs enterprise demo, new Hydrogen partnership, open-source repo - anatomy/index: new Features landing page (fixes /docs/anatomy 404) - getting-started: Node 24 callout, Deploy to Vercel section, Shopify credential links, drop the deploy button - shopify-setup: Headless install steps, required-permissions table, storefront ID attribution, optional features section - extending-with-agents: full skills table, harness-agnostic wording Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
- index: mention skills in the intro, reframe "two ways to start" as one path (template) plus the enterprise demo as a showcase, drop the stabilization framing for Hydrogen, fix the suspended hyphen, simplify the open-source lines - getting-started: neutral callouts, clarify creating a storefront in the Headless app, add a note to publish products if none appear, rename "Next steps" to "Related links" - shopify-setup: re-add the Vercel Marketplace channel callout, rename the publish section, fold the Online Store warning into prose, move the storefront ID to its own section as an env var, neutral callouts - extending-with-agents: expand the intro, make the skill run harness- agnostic, unwrap the update-shop link from code - switch all callouts to the neutral geist variant Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
- Intro: add Horizon feature-parity and new Hydrogen positioning, expand security (BotID, firewall, DDoS) and composability, and drop the repo link on "Open source" - Setup: add a Prerequisites section (Node 24, pnpm, store), remove nvm guidance, reword the deploy step, and rename to "Setup Environment" - Shopify Setup: rename to "Setup Shopify", clarify the storefront ID heading, and note the pdp.bundles.isEnabled setting - Extending with Agents: add fx to the supported harnesses - Authentication: add a Portless local-HTTPS callout (moved from Setup) Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Contributor
|
You must have Developer access to commit code to Vercel Labs on Vercel. If you contact an administrator and receive Developer access, commit again to see your changes. Learn more: https://vercel.com/docs/accounts/team-members-and-roles/access-roles#team-level-roles |
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
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
Refreshes the first onboarding docs pages ahead of the mid-October GA launch, so the setup experience reads clearly and communicates what Vercel Shop offers. Copy edits only. No code or template changes.
Introduction (
docs/index.mdx)Setup Environment (
docs/getting-started/index.mdx)Setup Shopify (
docs/getting-started/shopify-setup.mdx)pdp.bundles.isEnabledis on (the default).Authentication (
docs/anatomy/authentication.mdx)Extending with Agents (
docs/getting-started/extending-with-agents.mdx)Verification
pnpm lint(oxlint + oxfmt --check): pass🤖 Generated with Claude Code