Parent epic: #768 — Documentation epic
Base branch: theme-elementary-v2. Cover its functionality and subsequent changes based on it. Verify against the latest relevant v2 implementation and record the tested commit in the documentation PR.
Problem and scope
The current Quick Start mixes pilot workarounds, setup alternatives, and feature tutorials. Replace or supersede docs/quick-start-guide.md with docs/getting-started.md, ending at a working local theme.
Proposed structure
- Outcome and starting context: fresh standalone project versus a theme added to an existing WordPress/VIP repository.
- Prerequisites: supported versions and short verification commands; distinguish requirements for the recommended wp-env route from other existing local environments.
- Acquire the skeleton: one tested installation path for the supported revision. Keep temporary pilot exceptions behind a link.
- Install dependencies: explain actual Composer/npm behavior without duplicate installation steps.
- Personalize: use the CLI wizard or the supported AI alternative; explicitly state that both are not required.
- Start and view the theme: minimal environment, activation, and build steps, with an expected URL/result.
- Next task: links to daily development, included functionality, and extension examples.
Context and checkpoints
- State the working directory for commands.
- For an existing repository, show the destination theme directory and distinguish theme-local scripts/instructions from root-level project tooling. Link to the relevant project/VIP guide; do not imply init is safe at the wp-content root.
- After personalization, review identity and cleanup changes; suggest a baseline commit before feature work.
- Confirm the theme loads and a source edit appears. Detailed troubleshooting belongs in the relevant guide.
- Update links from the old Quick Start location.
Acceptance criteria
Parent epic: #768 — Documentation epic
Base branch:
theme-elementary-v2. Cover its functionality and subsequent changes based on it. Verify against the latest relevant v2 implementation and record the tested commit in the documentation PR.Problem and scope
The current Quick Start mixes pilot workarounds, setup alternatives, and feature tutorials. Replace or supersede
docs/quick-start-guide.mdwithdocs/getting-started.md, ending at a working local theme.Proposed structure
Context and checkpoints
Acceptance criteria