⚙️ 🤖 `RELEASES`-File obsolet vs. behalten — Entscheidung dokumentieren #6

New issue

Open

opened 2026-06-09 14:59:13 +02:00 by holm · 0 comments

holm commented

2026-06-09 14:59:13 +02:00

Owner

Dimension	Bewertung	Einschätzung
Aufwand	`██░░░░░░░░`	Niedrig — Doku-Entscheidung + ggf. Cleanup
Nutzen	`██░░░░░░░░`	Niedrig — Klarheit für künftige Stack-Setups
Bruchhäufigkeit	`█░░░░░░░░░`	Sehr niedrig
Nachhaltigkeit	`████████░░`	Hoch — einmal entschieden, dauerhaft
Dringlichkeit	`█░░░░░░░░░`	Sehr niedrig

Problem

Im TaskfileMain.yml-release-Task ist cat RELEASES als Fallback wenn doc-rel.sh nicht vorhanden ist. In Stacks, die doc-rel.sh verfügbar haben, ist RELEASES damit redundant.

Frage

Variante A — RELEASES behalten als Doku-Artefakt für menschliche Leser (lesbar ohne doc-rel zu starten).
Variante B — phasenweise rauswerfen, einzige Quelle ist doc-rel-Output.

Trade-offs

Aspekt	A (behalten)	B (rauswerfen)
Lesbarkeit ohne Tool	✓	✗
Drift-Risiko (RELEASES vs. Live-Status)	✗	✓
Pflegeaufwand pro Stack	+	0

Akzeptanzkriterien

Entscheidung getroffen + im doc-rel-README begründet
Bei B: Migrations-Hinweis in Stack-Templates
Bei A: Konvention dokumentieren (was steht drin, wer pflegt)

🤖 angelegt von Claude o00 (API/Token holm)

| Dimension | Bewertung | Einschätzung | |---|---|---| | Aufwand | `██░░░░░░░░` | Niedrig — Doku-Entscheidung + ggf. Cleanup | | Nutzen | `██░░░░░░░░` | Niedrig — Klarheit für künftige Stack-Setups | | Bruchhäufigkeit | `█░░░░░░░░░` | Sehr niedrig | | Nachhaltigkeit | `████████░░` | Hoch — einmal entschieden, dauerhaft | | Dringlichkeit | `█░░░░░░░░░` | Sehr niedrig | ## Problem Im `TaskfileMain.yml`-`release`-Task ist `cat RELEASES` als Fallback wenn `doc-rel.sh` nicht vorhanden ist. In Stacks, die `doc-rel.sh` verfügbar haben, ist `RELEASES` damit redundant. ## Frage - **Variante A** — `RELEASES` behalten als Doku-Artefakt für menschliche Leser (lesbar ohne doc-rel zu starten). - **Variante B** — phasenweise rauswerfen, einzige Quelle ist `doc-rel`-Output. ## Trade-offs | Aspekt | A (behalten) | B (rauswerfen) | |---|---|---| | Lesbarkeit ohne Tool | ✓ | ✗ | | Drift-Risiko (RELEASES vs. Live-Status) | ✗ | ✓ | | Pflegeaufwand pro Stack | + | 0 | ## Akzeptanzkriterien - [ ] Entscheidung getroffen + im doc-rel-README begründet - [ ] Bei B: Migrations-Hinweis in Stack-Templates - [ ] Bei A: Konvention dokumentieren (was steht drin, wer pflegt) > 🤖 angelegt von Claude o00 (API/Token holm)

holm added the

Kind/Documentation

Priority/Low

labels

2026-06-09 14:59:13 +02:00