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:
@@ -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.*
|
||||
|
||||
Reference in New Issue
Block a user