The docs at /inside/docs/ are static pages built by scripts/build_docs.py from markdown files in scripts/docs/<space>/. Two spaces are written by hand in the repository; two come from the knowledge vault through scripts/import_vault_docs.py.
Build
python3 scripts/import_vault_docs.py ~/vault # vault spaces: sre, std (only on the machine with the vault)
python3 scripts/build_docs.py # all spaces, sitemap block, llms.txt section, search indexThe build writes one index.html per page, inside/docs/search.json for the search box, a managed block in sitemap.xml and a managed section at the end of llms.txt. Then run the gate dry run and push as usual.
Front matter
| Field | Use |
|---|---|
title, summary | Required. The summary is the meta description, the line in child-page lists and the search snippet |
parent | Slug of the parent page in the same space; empty means under the space home |
order | Sort key among siblings |
labels | Comma-separated; written as article:tag metas and shown as chips |
created, updated | Dates; without them the build uses the git date of the source file |
origin, reviewed | Vault pages only: the vault path, and no for the review label |
Links
[text](doc:space/slug)links to another docs page; an unknown target stops the build.- Vault notes keep their wikilinks. A wikilink to a note in the export becomes a link; a link to a note outside it shows as plain text with a dotted underline.
- Every page lists the pages that link to it under "Linked from".
In the map
Each page carries <meta name="docs-space">, article:tag metas, dates and <link rel="up"> to its parent. The map crawler turns those into doc nodes, tree links and labels, so the documentation is part of the map of the work.
Vault import rules (2026-10-09)
- In:
SRE/withouthomelab/,.claude/andCLAUDE.md; 28 standards clusters underpillars/. - Redacted: private IPv4 addresses and LAN shorthand, e-mail addresses, the former employer's name, home directory paths, private host names. Each change is listed in
scripts/docs/IMPORT-REPORT.md. - ISO clause notes: blockquotes are dropped unread, so no standards text is machine-processed.
- Every vault page carries a label: not reviewed against the source.