Renders the cohere docs site: authored markdown in docs_src/ becomes
static HTML in docs/, alongside pages derived from the compiled tasks
and the repo's own coherence artifacts.
The site is built on the tool's own split — derived where possible (command reference from task moduledocs, the self page from the live map), authored where necessary (the narrative pages). The renderer covers only the constrained markdown subset the authored pages use; we author the input, so completeness is a non-goal — the same judgment as hand-parsed frontmatter over a YAML dependency.
Rendering is deterministic: same sources in, same bytes out. Nothing
here reads a clock, the network, or git state, so a CI rebuild plus
git diff --exit-code docs/ is a complete freshness gate.
Summary
Functions
Builds the site.
The canonical site render into a given directory — one invocation, used
by docs_src/build.exs and registered with the freshness gate
(config :cohere, derived:), so a manual rebuild cannot differ from a
gated one by flag drift.
Renders the constrained markdown subset to HTML: #–#### headings
(with slug ids), paragraphs, fenced and four-space-indented code blocks,
inline code/bold/italic/links, flat lists, blockquotes, rules, and raw
HTML passthrough for block-level tags.
Functions
Builds the site.
Options:
:src— source directory (default"docs_src"):out— output directory (default"docs"):base_url— absolute site root, used for links inllms.txt
The canonical site render into a given directory — one invocation, used
by docs_src/build.exs and registered with the freshness gate
(config :cohere, derived:), so a manual rebuild cannot differ from a
gated one by flag drift.
Renders the constrained markdown subset to HTML: #–#### headings
(with slug ids), paragraphs, fenced and four-space-indented code blocks,
inline code/bold/italic/links, flat lists, blockquotes, rules, and raw
HTML passthrough for block-level tags.