Today — CI has no cargo doc step (just ci is fmt, clippy, test, deny, schemas, pins, skill) and no crate enables missing_docs. Measured on 3822283: cargo doc --workspace --no-deps produces 0 warnings today, so adding the gate costs nothing. A scan finds about 42 undocumented public items: 14 in launchbound-bench, 8 in -space, 5 of 6 in -tui, 5 in -report, 4 in -build, the rest scattered.
Fix. A docs recipe (RUSTDOCFLAGS=-D warnings cargo doc --workspace --no-deps) in just ci; #![warn(missing_docs)] in every library crate; then document the 42, with invariants and a runnable example on the public entry points (enumerate, decide, estimate).
Done when
Today — CI has no
cargo docstep (just ciis fmt, clippy, test, deny, schemas, pins, skill) and no crate enablesmissing_docs. Measured on3822283:cargo doc --workspace --no-depsproduces 0 warnings today, so adding the gate costs nothing. A scan finds about 42 undocumented public items: 14 inlaunchbound-bench, 8 in-space, 5 of 6 in-tui, 5 in-report, 4 in-build, the rest scattered.Fix. A
docsrecipe (RUSTDOCFLAGS=-D warnings cargo doc --workspace --no-deps) injust ci;#![warn(missing_docs)]in every library crate; then document the 42, with invariants and a runnable example on the public entry points (enumerate,decide,estimate).Done when
just ciand green withmissing_docson.