Repoint ADR references after HQ consolidated 65 records to 23
96 comments across the two repos named records that no longer exist. Each now points at the consolidated record that holds its reasoning -- ADR 0034 (a test defends a decision) is 0017, the eight host records are 0005, the four lab records are 0016. Worth noting for next time: these are references from outside HQ, so renumbering there is not free. It cost 38 files here.
This commit is contained in:
@@ -13,7 +13,7 @@ import (
|
||||
// way to run something — and refuses the other three. That is not a broken host: a declaration
|
||||
// naming a shape this host does not implement is refused whole, the same treatment an unknown
|
||||
// type gets, and the profile tells the control plane which shapes exist so it never sends one
|
||||
// it cannot do (novox/hq ADR 0060).
|
||||
// it cannot do (novox/hq ADR 0005).
|
||||
//
|
||||
// What it cannot do, and why:
|
||||
//
|
||||
@@ -24,13 +24,13 @@ import (
|
||||
// and an unlocked bootloader. On a normal device nothing can register with it.
|
||||
// - **container** — no container runtime, and no kernel access to give one.
|
||||
//
|
||||
// **This host is EPISODIC** (novox/hq ADR 0062). Everywhere else an init runs the launcher at
|
||||
// **This host is EPISODIC** (novox/hq ADR 0005). Everywhere else an init runs the launcher at
|
||||
// boot and the launcher supervises the host. Android grants neither: nothing to register with
|
||||
// without root, and nothing worth supervising, because a supervisor would be killed alongside
|
||||
// what it supervises.
|
||||
//
|
||||
// So it runs when the platform allows and is killed when the platform wants the memory — and
|
||||
// that is **disconnection**, which ADR 0036 already made an ordinary situation rather than an
|
||||
// that is **disconnection**, which ADR 0004 already made an ordinary situation rather than an
|
||||
// exception. It needs no keep-alive and no new mechanism: the store is already authoritative
|
||||
// while disconnected, reconcile already happens on start, and the mesh already reports *last
|
||||
// heard from* rather than alarming on silence.
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
// Package system is the part of the host that differs between operating systems.
|
||||
//
|
||||
// novox/hq ADR 0060. A machine has apk because it is Alpine; the package manager, the service
|
||||
// novox/hq ADR 0005. A machine has apk because it is Alpine; the package manager, the service
|
||||
// manager and the packaging format arrive together as one decision somebody made at install
|
||||
// time. So they are not independent knobs — they are one implementation, named after the system
|
||||
// it belongs to.
|
||||
@@ -75,7 +75,7 @@ func Supports(s System, t declaration.Type) bool {
|
||||
// Check refuses a declaration naming a shape this host cannot apply.
|
||||
//
|
||||
// Refused whole and before anything is applied, which is the same treatment an unknown type
|
||||
// gets (novox/hq ADR 0043) — a host that applied the parts it understood would leave a machine
|
||||
// gets (novox/hq ADR 0005) — a host that applied the parts it understood would leave a machine
|
||||
// that looks configured and is not. The reason differs and the outcome does not.
|
||||
func Check(s System, d *declaration.Declaration) error {
|
||||
var problems []string
|
||||
@@ -116,7 +116,7 @@ func everyShape() []declaration.Type {
|
||||
// portableShapes need only a filesystem and a way to run something.
|
||||
//
|
||||
// The floor. A host that can do nothing else can still do these, which is what makes a partial
|
||||
// host a real thing rather than a broken one (novox/hq ADR 0060).
|
||||
// host a real thing rather than a broken one (novox/hq ADR 0005).
|
||||
func portableShapes() []declaration.Type {
|
||||
return []declaration.Type{
|
||||
declaration.TypeDirectory, declaration.TypeFile, declaration.TypeAction,
|
||||
|
||||
@@ -238,7 +238,7 @@ func TestOpenRCBootStateComesFromTheRunlevel(t *testing.T) {
|
||||
}
|
||||
|
||||
func TestEachSystemUsesItsOwnCommands(t *testing.T) {
|
||||
// The whole point of ADR 0060: the alpine host must never reach for systemctl, and the arch
|
||||
// The whole point of ADR 0005: the alpine host must never reach for systemctl, and the arch
|
||||
// host must never reach for rc-service.
|
||||
for _, tc := range []struct{ name, forbidden string }{
|
||||
{"arch", "rc-service"},
|
||||
|
||||
Reference in New Issue
Block a user