Documentation Maintenance

Documentation Maintenance

1. Read the root AGENTS.md, docs/AGENTS.md, and the relevant documentation, implementation, schema, and tests before editing.

2. Keep Chinese pages and their docs/en/ counterparts behaviorally aligned. Preserve option names, JSON keys, CLI flags, provider IDs, and examples.

3. For new or removed pages, update both locale navigation and sidebars in docs/.vitepress/config.mts, then update docs/llms.txt.

4. Use relative links for internal documentation and full URLs for external destinations. Keep each locale within its own documentation tree.

5. Edit source content only: root README.md and README.en.md generate the documentation home pages; do not edit or commit docs/.vitepress/dist/.

6. Treat docs/public/install.sh and docs/esa.js as executable code. Preserve their runtime contracts and review downloads, redirects, caching, and inputs.

7. When dependency installation is permitted, validate with:

   npm --prefix docs ci
   npm --prefix docs run build
   

Report changed files and any validation not run.