osm-katana/.nornir/docs.toml
# Book routing for `nornir docs book osm-katana` (the doctrine's three PDFs). A source's
# class comes from its filename suffix (-design.md, -guide.md, -for-idiots.md, -reasoning.md,
# -history.md, -unsorted.md, -benchmarks.md) or an explicit `<!-- nornir:class: X -->` marker;
# an unsuffixed file (README.md, osm-katana.md) defaults to the `readme` class.
# Mirrors the parent znippy-zoomies/.nornir/docs.toml. osm-katana's STAR is the `benchmarks`
# class — the `convert vs osmium/osmconvert` bake-off (self=osm-katana) — which routes into
# manual.pdf, exactly like the decompressor bake-off does for znippy-zoomies.
[book.manual] # crisp core — README ⊂ manual, design/guide, + the convert bake-off numbers
classes = ["readme", "changelog", "design", "guide", "benchmarks"]
out = "docs/manual.pdf"
[book.idiot_guide] # zero-knowledge, every step
classes = ["idiot"]
out = "docs/idiot_guide.pdf"
[book.unsorted] # the why + the record + the holding pen
classes = ["reasoning", "history", "unsorted"]
out = "docs/unsorted.pdf"