Documentation contribution
Curate MDX in the website repository and validate the complete static product.
Make the content reviewable
Add a page under content/. Its path is its URL: content/docs/concepts/plans.mdx publishes at /docs/concepts/plans. Frontmatter carries the title, description, product tracks, exact version selections, and optional pinned sources. Sidebar order and section titles live in the folder's meta.json. Use the shared cards, callouts, topic lists, and code treatment; avoid page-specific CSS.
Product claims must be checked against the selected tagged source when the page is written. Source links render in the page footer; nothing verifies them at build time. A missing historical guide remains visibly unavailable.
Run the website checks
pnpm install --frozen-lockfile
pnpm lint
pnpm typecheck
pnpm theme:check
pnpm test -- --runInBand
pnpm build
pnpm static:checkThe build rejects frontmatter outside the page schema. The static check confirms every content page, release note, changelog, and redirect target was exported, and that search finds titles and body text. Browser checks additionally exercise routes, search, the changelog filters, mobile navigation, theme switching, keyboard focus, and accessibility. Review incomplete accessibility results manually.
Respect the static boundary
The website exports HTML, CSS, JavaScript, and a static search index. It has no CMS, database, authentication, live repository API, or server persistence. Hosted Plausible loads only for an explicitly configured production deployment. Cloudflare Pages configuration is documented; connecting or publishing a production project is a separate action.