Expand description
Documentation generation: schema + intent + comments → Markdown, searchable HTML, and man pages (C-048, spec/docgen.md). Secret values render redacted in every format (C-036).
Structs§
- DocItem
- One documented configuration item: a dotted value path with its type, value, and prose.
Functions§
- collect_
items - Collect documentation items depth-first in source order from the evaluated value tree, enriched with schema data, annotations, and attached comments.
- doc_
to_ html - One page with inline CSS and a filter box: typing hides
non-matching
.fieldblocks (substring, case-insensitive). - doc_
to_ man - Man page:
.THheader,.SH NAMEsummary, one.TPentry per item with type/required/value/description body lines. - doc_
to_ markdown - Reference page:
# Title, one## tablesection per top-level table (## Generalfor root scalars),### pathitems with a type/required/default/value line, description paragraphs, constraint bullets, and deprecation quotes.