Skip to content

docs: a Reference page per language - #41

Merged
Kinflou merged 1 commit into
mainfrom
docs/language-reference
Oct 18, 2026
Merged

Kinflou merged 1 commit into
mainfrom
docs/language-reference

Conversation

@Kinflou

@Kinflou Kinflou commented Oct 18, 2026

Copy link
Copy Markdown
Member

Moves feature support out of Reference → Tools (next to the CLI) into a per-language specification.

  • Reference → Languages → Overview explains the four states and how conformance proves them, then shows the code generators side by side.
  • Reference → Languages → Rust / TypeScript each have:
    • Code generation: every feature with what it covers, the state and note, the tracking issue, and the fixtures that prove it;
    • Runtime: a placeholder until runtime conformance covers the language. That work is next, in the runtime repo, followed by comline-typescript.
  • scripts/sync-language-support.py renders all three from generation's features.json (structured, not the Markdown table). A generator with no page is an error that names the page to add. It replaces sync-generator-support.py, and the drift workflow is renamed to language-support-drift.yml.
  • The validator guide and the CLI reference link to the new pages.

The strict build is clean, --check passes against generation's features.json, and check-cli-drift.py passes.

Reference → Languages has an overview (the states, how claims are proven,
the side-by-side matrix) and one page per language: its code generation
support, feature by feature, with the fixtures that prove it, and a Runtime
section for when runtime conformance covers it. scripts/sync-language-support.py
renders them from generation's features.json, replacing the single generator
support page under Tools and its sync script.
@Kinflou
Kinflou merged commit 340d871 into main Oct 18, 2026
5 checks passed
@Kinflou
Kinflou deleted the docs/language-reference branch October 18, 2026 17:20
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant