instructions/dev/issue-tracking.md: destructive-step invariants, comment-vs-body authority, rename sweep (#47 Block 1, #29)
Files changed: - CHANGES.md - VERSION - instructions/dev/issue-tracking.md
This commit is contained in:
+50
@@ -35,6 +35,56 @@ dev-checkout concern - readable here, never shipped as something to parse.
|
||||
|
||||
---
|
||||
|
||||
## 4.5.1 - 2026-09-04 - issue-tracking - destructive-step invariants, comment-vs-body authority, rename sweep
|
||||
|
||||
**Author:** Torben Nehmer
|
||||
|
||||
<!-- wikitool:bumps -->
|
||||
- issue-tracking - destructive-step invariants, comment-vs-body authority, rename sweep
|
||||
<!-- /wikitool:bumps -->
|
||||
|
||||
Block 1 aus #47 (gemeinsam mit #29): drei Ergänzungen an
|
||||
`instructions/dev/issue-tracking.md`, ausgelöst durch zwei Fehlerklassen, die
|
||||
in derselben Sitzung am Stack aufgetreten waren.
|
||||
|
||||
- **Schritt 1** trägt jetzt, dass destruktive Schritte im Body die Invariante
|
||||
nennen müssen, die sie nicht verletzen dürfen, und dass ein
|
||||
Akzeptanzkriterium eine prüfbare Eigenschaft ist, keine Tätigkeit. Auslöser
|
||||
war #30: der Body schrieb wörtlich "Arbeitsverzeichnis entfernen" für den
|
||||
`upstream merge`-Ablauf, und genau das wurde zum datenvernichtenden Bug -
|
||||
ein `shutil.rmtree` auf eine Stage mit gitignorierten, nicht
|
||||
rekonstruierbaren Daten.
|
||||
- **Schritt 2** trägt jetzt die Lesesicht auf Body und Kommentare, die es
|
||||
bisher nur aus Autorensicht gab: der Body ist der Stand, Kommentare sind
|
||||
Historie; ein erkennbar veralteter Body wird richtiggestellt statt
|
||||
umgangen; widersprüchliche Kommentare werden nach Beleg aufgelöst, nicht
|
||||
nach Datum. Auslöser war ebenfalls #30 (ein Kommentar empfahl das Gegenteil
|
||||
dessen, was der Body später festlegte) und #10 (ein seit Tagen veralteter
|
||||
Body gegen drei widersprechende Kommentare, zwei davon sich selbst
|
||||
widersprechend).
|
||||
- Neuer Abschnitt **"Renames and other decay in the tracker"** nach Schritt 7:
|
||||
ein Rename ist erst fertig, wenn auch die offenen Issues nachgezogen sind,
|
||||
weil `wikitool` diesen Tracker nicht kennt und nicht kennenlernen soll. Mit
|
||||
der Wegweiser-vs-Beleg-Unterscheidung aus #29 und dem Hinweis, dass auch
|
||||
verschwundene `kb/`-Seiten und private Infrastrukturangaben Issue-Texte
|
||||
altern lassen. Ein neuer Trigger in "When to run" verweist darauf.
|
||||
|
||||
Keine der drei Ergänzungen verschiebt die bestehende Nummerierung der
|
||||
Schritte 1-7 - die Querverweise darauf (u. a. aus
|
||||
`instructions/dev/stack-dev/SKILL.md` auf Schritt 7, aus
|
||||
`kb/concepts/Issue Label Scheme.md` auf Schritt 2) bleiben also gültig, ohne
|
||||
angefasst zu werden.
|
||||
|
||||
Verifiziert: `tools/wikitool instructions verify`, `tools/wikitool docs
|
||||
verify`, beide grün (Prosa-only, kein Interface geändert, PATCH).
|
||||
|
||||
#47 bleibt offen (Block 2: der Skill-Schnitt aus Vorschlag E; Block 3: die
|
||||
beiden Nebenbefunde). #29 bleibt ebenfalls offen: dieser Block deckte nur den
|
||||
Regelabsatz, nicht den noch ausstehenden Pfad-Durchgang durch #4, #5, #15,
|
||||
#21, #16, #26 - der war nicht Teil des Auftrags für diesen Block.
|
||||
|
||||
---
|
||||
|
||||
## 4.5.0 - 2026-09-04 - Beide Update-Wege in Code: upstream merge fuer Clones, dist upgrade fuer Tarball-Instanzen
|
||||
|
||||
**Author:** Torben Nehmer
|
||||
|
||||
Reference in New Issue
Block a user