From 82f34b2c09a92279ac8a2bb73108d07e23df3ed7 Mon Sep 17 00:00:00 2001 From: mhoennig Date: Sun, 16 Aug 2026 12:05:01 +0200 Subject: [PATCH] rename: `example-werkbaum.werkbaum` zu `werkbaum.werkbaum`. --- CLAUDE.md | 2 +- README.md | 2 +- docs/DECISIONS.md | 12 ++++++------ .../{example-werkbaum.werkbaum => werkbaum.werkbaum} | 0 frontend/src/app.js | 2 +- scripts/promote-shipped.sh | 2 +- 6 files changed, 10 insertions(+), 10 deletions(-) rename docs/examples/{example-werkbaum.werkbaum => werkbaum.werkbaum} (100%) diff --git a/CLAUDE.md b/CLAUDE.md index 5a4d636..0551399 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -27,7 +27,7 @@ Integrations-Backend. - Keine neuen Laufzeit-Abhängigkeiten ohne Rückfrage (gilt in beiden Teilen). - Der Notationstext ist das führende Datenformat; kein Teil erfindet ein eigenes Speicherformat für die Struktur. -- Im mitgelieferten Plan `docs/examples/example-werkbaum.werkbaum` bekommt eine +- Im mitgelieferten Plan `docs/examples/werkbaum.werkbaum` bekommt eine fertige Funktion beim Mergen **`[x]`**, nicht `[^]`. Auf „in Produktion" befördert erst der Deploy der stabilen Instanz (`scripts/promote-shipped.sh`, von `deploy-prod.sh` aufgerufen) — nur er macht diff --git a/README.md b/README.md index eced310..475dd59 100644 --- a/README.md +++ b/README.md @@ -253,7 +253,7 @@ SSH (target in `.env`, template `.env.example`). Unlike Pages this is a **deliberate** step, so it is also the moment a feature actually goes live. The script therefore starts by running `scripts/promote-shipped.sh`, which turns -`[x]` (done) into `[^]` (in production) in `docs/examples/example-werkbaum.werkbaum` +`[x]` (done) into `[^]` (in production) in `docs/examples/werkbaum.werkbaum` — the shipped plan describing Werkbaum itself — and records that as its own commit. The convention is: mark a finished feature `[x]` when it is merged and let the deploy promote it. That keeps the plan honest on both instances and diff --git a/docs/DECISIONS.md b/docs/DECISIONS.md index b352ac4..f6238a1 100644 --- a/docs/DECISIONS.md +++ b/docs/DECISIONS.md @@ -458,11 +458,11 @@ http(s) erreichbare Textdatei unabhängig von Endung und Content-Type. Es gibt also keinen Bruch für bestehende Links. **Beispieldateien liegen unter `docs/examples/`** (`example-plan-0…3.werkbaum`, -`example-werkbaum.werkbaum`) statt einzeln in `docs/`. Mehrere Beispiele, weil +`werkbaum.werkbaum`) statt einzeln in `docs/`. Mehrere Beispiele, weil sich das Umschalten zwischen Dokumenten (D22) erst mit mehreren *geladenen* Dokumenten zeigen lässt: jeder `?sourceUrl=`-Link legt ein eigenes Dokument an (id aus der URL, D23), nacheinander geöffnet stehen sie danach alle im Wähler. -`example-werkbaum.werkbaum` beschreibt Werkbaum selbst (Bestand + mögliche +`werkbaum.werkbaum` beschreibt Werkbaum selbst (Bestand + mögliche Weiterentwicklung, destilliert aus ROADMAP/TASKS/DECISIONS) — zugleich Beispiel und lebende Projektübersicht; bei größeren Änderungen mitpflegen. @@ -504,7 +504,7 @@ unsichtbaren `div` mit gleicher Typografie und Breite plus Marker-Span (`offsetTop`). Gescrollt wird nur, wenn die Zeile nicht ohnehin sichtbar ist. **Gegenrichtung (Cursor-Zeile → Knoten)** ist bei großen Bäumen die nützlichere -Hälfte: `example-werkbaum.werkbaum` hat 75 sichtbare Knoten, ohne Markierung +Hälfte: `werkbaum.werkbaum` hat 75 sichtbare Knoten, ohne Markierung verliert man beim Tippen die Orientierung. Der Knoten der Cursor-Zeile bekommt die Klasse `current`; ins Bild gescrollt wird **nur beim Zeilenwechsel**, sonst ruckelte das Diagramm bei jedem Tastendruck. Vor der ersten Cursor-Bewegung ist @@ -660,7 +660,7 @@ einen `?sourceUrl=`-Link erreichbar; zugleich dient er als lebende Projektübersicht. **Eine Quelle, keine Kopie.** Der Text wird per `?raw`-Import aus -`docs/examples/example-werkbaum.werkbaum` gezogen — derselben Datei, die auch +`examples/werkbaum.werkbaum` gezogen — derselben Datei, die auch der `?sourceUrl=`-Link lädt. Vite bettet sie beim Build in die eine Ausgabedatei ein (D19), es wird nichts nachgeladen (D20). Eine zweite, abgetippte Fassung im Quelltext würde unweigerlich auseinanderlaufen. (Nebenwirkung: die Beispieldatei @@ -989,7 +989,7 @@ war. Beide stehen jetzt auf `[x]` und leuchten beim nächsten Prod-Deploy als ne auf, was genau der Wahrheit entspricht. **Umfang: genau eine Datei, bewusst kein Muster.** Befördert wird nur -`docs/examples/example-werkbaum.werkbaum` — allein der Werkbaum-eigene Plan sagt +`examples/werkbaum.werkbaum` — allein der Werkbaum-eigene Plan sagt etwas über das Deployment aus. `[x]` steht im Repo an mehreren Stellen, wo eine Beförderung falsch bis unsinnig wäre: @@ -1417,7 +1417,7 @@ Betrachter hinter derselben IP. Das ist ehrlich machbar, aber es sind nicht die gewünschten 2 s — und es ist schlechter als der Knopf, sobald mehrere zuschauen. Die Alternativen stehen als any-of-Gruppe im mitgelieferten Plan -(`docs/examples/example-werkbaum.werkbaum`, unter „Update by itself"); die beiden +(`examples/werkbaum.werkbaum`, unter „Update by itself"); die beiden gemessenen Sackgassen als `[-]` mit dem Messergebnis im Kommentar, damit niemand sie erneut aufmacht. Der günstigste Pfad wählt dort von selbst die Rate-Limit-Anhebung — die billigste wirksame Änderung. diff --git a/docs/examples/example-werkbaum.werkbaum b/docs/examples/werkbaum.werkbaum similarity index 100% rename from docs/examples/example-werkbaum.werkbaum rename to docs/examples/werkbaum.werkbaum diff --git a/frontend/src/app.js b/frontend/src/app.js index f28edbb..57bd0cf 100644 --- a/frontend/src/app.js +++ b/frontend/src/app.js @@ -8,7 +8,7 @@ import { padUrls } from './remote.js'; Dieselbe Datei, die auch per ?sourceUrl= geladen werden kann; `?raw` bettet sie beim Build in die eine Ausgabedatei ein (D19), es wird nichts nachgeladen (D20). Quelle bleibt docs/examples/ — keine Kopie, die auseinanderläuft. */ -import WERKBAUM_DOC from '../../docs/examples/example-werkbaum.werkbaum?raw'; +import WERKBAUM_DOC from '../../docs/examples/werkbaum.werkbaum?raw'; const INITIAL = `%% Project structure – Sprint 14 [~] Website relaunch (XL) https://wiki.example.com/relaunch diff --git a/scripts/promote-shipped.sh b/scripts/promote-shipped.sh index f546e2c..83f6b38 100755 --- a/scripts/promote-shipped.sh +++ b/scripts/promote-shipped.sh @@ -2,7 +2,7 @@ # # Werkbaum — „fertig" auf „in Produktion" befördern. # -# Der mitgelieferte Plan docs/examples/example-werkbaum.werkbaum beschreibt +# Der mitgelieferte Plan docs/examples/werkbaum.werkbaum beschreibt # Werkbaum selbst. SPEC §4 unterscheidet `[x]` fertig (abgeschlossen) von `[^]` # in Produktion (deployed/live) — und die zweite Aussage kann erst der Deploy # wahr machen. Konvention deshalb: beim Mergen `[x]`, unmittelbar VOR dem