ludic/tools
Orkuncakilkaya 51ddfa3ce9
Some checks failed
docs / build-and-deploy (push) Failing after 38s
docs: automated documentation pipeline (per-symbol source → pages)
Replace the hardcoded landing page and minimal reference with a generated
documentation site driven by a single source of truth.

- docs/language/**: one file per symbol (93 keywords/types/builtins/namespace
  methods/operators/annotations), each with front-matter (id, kind, tokens,
  sig, tip) + description + a ```ludic example. Seeded by exploding the former
  inline SECTIONS list; these files are now the source of truth.
- docs/site/: site.json (editable hero/features/showcase/messaging, not
  hardcoded) + snippets/*.ludic (real programs shown on the landing page).
- tools/docgen/gen.py: generates index.html, api.html, ludic-highlight.js and
  symbols.json. The highlighter's symbol tables, hover tips and jump anchors
  are GENERATED from the per-symbol files — add a symbol and it is recognized,
  tipped and linked in every snippet automatically. Python stdlib only.
- tools/docgen/check.py: verifies the pages contract + that no snippet token
  links to a missing reference anchor.
- .forgejo/workflows/docs.yml: rebuilds and publishes to the pages branch on
  every push to main touching the docs sources.

Consumes the new Screen.*/Color.*/named-arg API and the 221-color palette.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-08-29 16:25:54 +03:00
..
docgen docs: automated documentation pipeline (per-symbol source → pages) 2026-08-29 16:25:54 +03:00
editors Networking N2–N6, and a fully C-free toolchain 2026-08-29 15:08:23 +03:00
git-hooks Baseline: Ludic compiler + toolchain, Phase 1 syntax fixes complete 2026-08-27 15:15:35 +03:00
ludic-tools Networking N2–N6, and a fully C-free toolchain 2026-08-29 15:08:23 +03:00
ludic-web Baseline: Ludic compiler + toolchain, Phase 1 syntax fixes complete 2026-08-27 15:15:35 +03:00
atlas.ludic Baseline: Ludic compiler + toolchain, Phase 1 syntax fixes complete 2026-08-27 15:15:35 +03:00
build-tools.sh Networking N2–N6, and a fully C-free toolchain 2026-08-29 15:08:23 +03:00
check-docs.py Phase 6a: rename core vocabulary (game/main/component/archetype/system) 2026-08-27 18:22:13 +03:00
check-vocabulary.py Phase 8b: modern names for the raw-memory and OS/IO primitives 2026-08-28 02:55:24 +03:00
test-grammar.js Baseline: Ludic compiler + toolchain, Phase 1 syntax fixes complete 2026-08-27 15:15:35 +03:00
test-lsp.py Phase 6a (cont.): reconcile editor toolchain with the rename 2026-08-27 18:34:57 +03:00
test-tools.sh Phase 6a (cont.): reconcile editor toolchain with the rename 2026-08-27 18:34:57 +03:00