website-md-language-docs

name	website-md-language-docs
description	Use when changing Ax website language docs, language-specific snippets, examples, API symbol mappings, generated package capabilities, or adding a new website language route. Keeps the markdown-only Hugo site source-audited and generated from repo truth.

Website-MD Language Docs

Use this skill when a change affects website/, Ax public APIs, examples, AxIR package docs, language capabilities, or docs that should appear in language-prefixed markdown routes.

Workflow

1. Inspect current repo truth first:
   • public exports in src/ax/index.ts
   • subsystem skills in src/ax/skills/
   • examples via npm run example -- list and the files it names
   • generated package metadata under packages/{python,java,cpp,go,rust}/
2. Update common prose once in website/content-src/templates/.
3. Put language-specific install commands, snippets, package labels, and API section mappings in website/content-src/languages/<language>.json.
   • Snippets may be plain arrays/strings for simple text, or metadata objects with code, fence, verified, illustrative, sourcePath, requiresCredentials, and notes.
   • Prefer sourcePath pointing at a checked-in runnable example when a snippet is meant to be copy/paste runnable.
   • Mark conceptual generated-language equivalents as illustrative or let the generator label them automatically.
4. Add or reorder pages only in website/content-src/site-map.json; generated pages read this manifest.