Skip to main content

soothfast_docs/
lib.rs

1//! Soothfast docs engine.
2//!
3//! Four rot channels, four mechanisms:
4//! - signatures can't rot: the API surface is read from rustdoc JSON
5//!   ([`surface`], [`mod@reference`], [`diff`]);
6//! - prose can't rot silently: bind blocks fingerprint the code they
7//!   describe, locked in `soothfast.lock` ([`markdown`], [`lockfile`]);
8//! - examples can't rot: every markdown `rust` block becomes a generated
9//!   test, capture blocks become runnable examples ([`gentests`]);
10//! - numbers can't rot: quantitative claims in prose evaluate against the
11//!   latest measurement baseline ([`claims`]).
12
13pub mod claims;
14pub mod diff;
15pub mod gentests;
16pub mod lockfile;
17pub mod markdown;
18pub mod reference;
19pub mod surface;