say which side is normative: the manifests define, these pages describe

The -impl suffix is borrowed from a world where the interface is normative and the
implementation conforms to it. Here the direction of authority runs the other way
and nothing said so, which is exactly the misreading the suffix invites.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
This commit is contained in:
2026-09-07 16:04:33 -04:00
co-authored by Claude Opus 5
parent 804ed08b84
commit 2f50a19453
+5
View File
@@ -17,6 +17,11 @@ inventory of what is running and at which version.* **That is
`jeffry/homelab-impl` and it is private**, because a version inventory is a target `jeffry/homelab-impl` and it is private**, because a version inventory is a target
list for anybody matching published vulnerabilities. list for anybody matching published vulnerabilities.
> **These documents describe the cluster; they do not define it.** *The manifests
> do.* **When a page here and the running cluster disagree, the cluster is right
> and the page is what gets corrected** — *which is why each one ends with how to
> check.*
> **Nothing on this side links to that side.** *A public page naming a private > **Nothing on this side links to that side.** *A public page naming a private
> thing as its answer costs the reader a request and their confidence in the rest > thing as its answer costs the reader a request and their confidence in the rest
> of the page.* > of the page.*