From 2f50a194536ad74869f07e5c473fc3f982295ec1 Mon Sep 17 00:00:00 2001 From: Jeff Gonzalez Date: Mon, 7 Sep 2026 16:04:33 -0400 Subject: [PATCH] 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) --- README.md | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/README.md b/README.md index 0f1c9af..7329f10 100644 --- a/README.md +++ b/README.md @@ -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 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 > thing as its answer costs the reader a request and their confidence in the rest > of the page.*