# The sigilOS docs web site

A static HTML site that renders the canonical docs from their **`.sdoc` AST** — using the **same
interpreter** as the CLI `doc` viewer, the Chrome app, and the macOS app. One engine, one AST, no
drift (Director #72).

## How it works
- `index.html` loads the canonical engine `../chrome-extension/sdoc.js` and the shared stylesheet
  `../chrome-extension/viewer.css`, then renders the selected doc with `SDOC.present(src, mount)`
  (which validates against `schema/SDOC_V1.md` and presents — inlining drawable SVG per the #72
  images ruling).
- `web/docs/*.sdoc` are the compiled artifacts. The doc index in `index.html` marks a doc **pending**
  until its `.sdoc` exists.

## Build (sync)
The `.sdoc` artifacts compile from the authored Markdown (`docs/*.md`, the per-subsystem `docs/` in
each repo) via **`sigdoc`** (Markdown → AST, all-Sigil). Until `sigdoc` lands, `web/docs/` is seeded
by hand (currently `overview.sdoc`). The site never re-parses Markdown — it only renders the AST, so
web and CLI can't diverge.

## Serve
Any static server, e.g. `python3 -m http.server` from the repo root, then open `/web/`. No build step.