doc-atoms

Explanatory documentation as atoms — tutorials, explanations, runbooks, how-tos, reference guides.

Explanatory documentation as atoms — tutorials, explanations, runbooks, how-tos, and reference guides. The narrative/teaching catalog of the convergent-systems.co ecosystem.

doc-atoms is not schema-atoms. schema-atoms is normative (specs and JSON Schemas). doc-atoms is explanatory (narrates, teaches, illustrates). If it tells you how to do something, it lives here. If it tells you what conformance requires, it lives there.

Catalog at v0.1.0

• 0 atoms across 0 types
• 0 document compositions

Atom types

• tutorial — guided learning, opinionated path from zero
• explanation — clarifying narrative, the "why" behind a concept
• runbook — operational procedure, ordered steps for a known scenario
• how-to — focused task answer, problem-shaped
• reference-guide — lookup-shaped, organized for non-linear reading

Civilization-grade properties

• Typed — every atom and composition validates against a JSON Schema.
• Versioned — every atom has a semver version field; compositions pin by version.
• Machine-readable — /exports/catalog.json is the canonical manifest.
• Composable — compositions reference atoms by ID; references resolve in CI.
• Open — Apache-2.0 (code) + CC-BY-4.0 (data).
• Signed — atoms-spec/v1.1.0 ML-DSA-65 signatures, post-quantum from inception.