Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Code Style

cochranblock uses the Token-Optimized Code Representation system from kova. Compact identifiers reduce token cost in AI-assisted development sessions without sacrificing readability once you know the mapping.

Identifier Conventions

PatternMeaning
f0f999Functions (handlers, helpers)
t0t9Types / structs
C0C9Constants (HTML template chunks)
v0v9Local variables within a function
p0p9Parameters

Common Identifiers

IdentifierWhat
t0Main app state struct (holds redb handle, config)
C7Skip-link + .cb-nav nav block + <main> opener
C8</main> + footer + closing tags
C9Self-contained nav shim (nav + scoped CSS + cosmic starfield)
f2_rootRoot subdomain dispatcher
f105Nav injector for standalone artifact pages

Handler Signature

#![allow(unused)]
fn main() {
pub async fn fNN(State(_p0): State<Arc<t0>>) -> Html<String> {
    let v0 = r#"<section>...</section>"#;
    Html([C7, v0, C8].concat())
}
}

Handlers that need the database:

#![allow(unused)]
fn main() {
pub async fn fNN(State(p0): State<Arc<t0>>) -> Html<String> {
    let db = p0.db.read().await;
    // ...
}
}

No Comments Rule

Comments only appear when the WHY is non-obvious (a hidden constraint, subtle invariant, or workaround). Well-named identifiers carry the what. The Timeline of Invention carries the why at the commit level.


THE COCHRAN BLOCK, LLC · CAGE 1CQ66 · UEI W7X3HAQL9CF9 · UNLICENSE · cochranblock.org