Ankh-Morpork¶

Documentation for the thaum.xyz home Kubernetes cluster — a k3s cluster in a cupboard, managed entirely through Flux.

How this documentation is organised¶

This site follows Diátaxis. The four sections above are document types, not subjects — the same component can appear in all four. A page belongs in a section based on what the reader is doing when they open it:

Each section states its own admission test. Read it before adding a page there — the framework only pays for itself if the boxes stay honest.

Where documentation lives¶

Two prior doc sets for this cluster died after being moved away from the code they described: docs/ went to a private Logseq, and the runbooks went to thaum-xyz/runbooks, which last received a commit in November 2021. What survived instead was everything that stayed inside the repository — the per-app READMEs, AGENTS.md, the deployment skill.

So the rule here is proximity:

• This site is built from docs/ in the ankhmorpork repository. The source is plain Markdown with no front matter, so every page stays readable on github.com and shows up in the diff that invalidates it. Only the rendering leaves the repo.
• Per-app documentation stays next to its manifests, at k8s/apps/<app>/README.md, for the same reason.
• Nothing here contains secrets, credentials, or break-glass paths. The repository is public on purpose. Anything failing that test does not belong on this site — see what stays private.