# arcana/doc/

Crate-owned documentation material for the `arcana` classical-crypto
crate. Following the split adopted for the workspace documentation
pack, each crate keeps its own documentation sources here:

* `papers/` — cited academic papers as PDFs (add with descriptive
  file-stem names so they map cleanly to BibTeX keys).
* `analysis/` — memory / timing / performance analysis notes.
* `sca/` — side-channel analysis annex (threat model, per-algorithm
  countermeasures, verification) — when arcana grows one.
* `specs/` — vendored RFCs / FIPS PDFs relevant to arcana.

The top-level `doc/` directory (repo root) hosts only workspace-level
material: the shared Sphinx configuration, the TOC contract
(`doc/TOC.md`), and cross-cutting infrastructure runbooks under
`doc/infra/`.

At build time `gendoc.sh` stages this directory under `doc/arcana/`
so Sphinx can reach it from its single source root. The crate-owned
material stays authoritative here; the staged copy under `doc/` is
gitignored.
