Skip to content

Zensical

This repository uses Zensical for user-facing documentation in docs/. Durable implementation notes for agents stay in docs/AI/.

Commands

Build the static site:

uv run zensical build

Build from a clean cache:

uv run zensical build --clean

Preview the site while editing:

uv run zensical serve

Preview on a specific address:

uv run zensical serve --dev-addr localhost:8000

API references

API pages live in docs/api/ and are generated with mkdocstrings from the runtime packages under src/.

Add a public API page with the ::: directive:

::: mp.coins.coins
    options:
      members:
        - CoinsConfig
        - CoinsParallelEnv
        - parallel_env

Then add the page to the API Reference section in zensical.toml. The Python handler is configured there with paths = ["src"], so imports should use the installed public module paths such as mp.coins.coins.

Structure

  • zensical.toml lives at the repository root so the Zensical CLI works without extra flags.
  • docs/index.md is the public documentation home page.
  • docs/substrates/ contains user-facing substrate pages.
  • docs/api/ contains generated API reference pages.
  • docs/development/ contains contributor workflow pages.
  • docs/AI/ is for agent-maintained technical notes and is intentionally not part of the main navigation.

Generated output is written to site/, which is ignored by git.