Yichen Jiang
f3ce8218cc
Append .md to any published route for the page as plain Markdown: the build emits a raw-Markdown twin of every route (frontmatter dropped, home bodies kept, images beside pages) plus a manifest-generated llms.txt, the dev server serves both per request, and the post-build gate fails when either is missing. Fixes #2846.
1.2 KiB
AGENTS.md — Documentation website adapter
Follow the root instructions, the documentation standard, and the documentation-site sync workflow.
Keep documentation content out of this tree
website/ owns only VitePress configuration, presentation assets, and the publication manifest. This file is the only maintained Markdown file in this subtree.
Keep canonical prose and generated catalogs in their owning docs/ tier, then expose selected pages through docs.ts. Never add locale, route, API, or copied documentation trees such as website/zh-CN/, website/en/, or website/api/.
The projector writes disposable Markdown to the ignored website/.generated/ directory. Never edit or commit .generated/, .cache/, or .dist/.
The build also emits each route's raw-Markdown twin and a root llms.txt index into .dist/, so <page URL>.md serves the page as plain Markdown. Both derive from the publication manifest at build time; neither is ever a file in this tree.
Run pnpm docs:check after changing this subtree; the gate rejects additional non-ignored Markdown under website/.