docs: Exit 42 als Haltung und die Adoption eines neuen Templates nachgezogen (#119)
CI / verify (push) Successful in 48s
Release / release (push) Successful in 36s

Files changed:
- CHANGES.md
- VERSION
- docs/ownership-and-templates.md
- docs/why-gates-are-code.md
This commit is contained in:
torben committed 2026-09-20 10:14:36 +02:00
1 parent 1d695f6536
commit 8ed8c6f5d9
4 files changed
+65 -3

No files matched your search

+9 -1
View File
@@ -149,7 +149,15 @@ becomes visible once an upgrade is a command rather than a hand-run copy:
- **`.template`-sourced files** - `USER.md`, `SOUL.md`, `kb/CONVENTIONS.md`, each
`kb/<name>/COLLECTION.md`, `ENVIRONMENT.md`, the `root: kb` type-specs - are never written by
an upgrade at all. The distribution ships only the `.template` beside them, so the filled file
is out of reach by construction rather than by a rule someone has to remember.
is out of reach by construction rather than by a rule someone has to remember. The same
property has a second face on the way in: when a release ships a `.template` for a type or
collection the instance does not have *yet*, the upgrade writes the template and stops - it
cannot write the filled file without deciding the instance's own language and wording for it.
Adoption is therefore an act the instance performs, and where the stack *requires* that type
(the `source` idiom, and `project` since 7.0.0) an upgrade that skips it leaves a tree
`docs verify` refuses. That is the ownership boundary working rather than a gap in it, but it
is the one shape in which "the upgrade never writes this file" turns into work somebody has to
do; `instructions/upgrade-instance.md` carries the step.
- **Seeded-once files** - `.wikitool-kb.json`, `CHANGES.md`, `kb/log.md`, `raw/.gitkeep` - are
written into a *new* instance by `dist export` and belong to the instance from then on. They
are the awkward category: they sit in the release stamp's file list like any other shipped