docs: automated documentation pipeline (per-symbol source → pages)
Some checks failed
docs / build-and-deploy (push) Failing after 38s

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>
This commit is contained in:
Orkun ÇAKILKAYA 2026-08-29 16:25:54 +03:00
parent a3a1e4d160
commit 51ddfa3ce9
121 changed files with 3827 additions and 0 deletions

View file

@ -0,0 +1,7 @@
---
id: random
title: Random
order: 7
---
A seeded, deterministic RNG — same seed, same sequence, every run and every platform.

View file

@ -0,0 +1,12 @@
---
id: random-chance
name: Random.chance
category: random
kind: namespace-method
tokens: Random.chance
sig: Random.chance(percent) -> bool
tip: True with the given percent probability.
order: 1
---
True with the given percent probability.

View file

@ -0,0 +1,16 @@
---
id: random-range
name: Random.range
category: random
kind: namespace-method
tokens: Random.range
sig: Random.range(low, high) -> int
tip: A random integer in the inclusive range [low, high].
order: 0
---
A random integer in the inclusive range [low, high].
```ludic
food_x = Random.range(low: 0, high: GRID_W - 1)
```

View file

@ -0,0 +1,12 @@
---
id: random-seed
name: Random.seed
category: random
kind: namespace-method
tokens: Random.seed
sig: Random.seed(value)
tip: Seed the RNG.
order: 2
---
Seed the RNG. Seeding with the same value makes runs reproducible.