rename: example-werkbaum.werkbaum zu werkbaum.werkbaum.

This commit is contained in:
mhoennig
2026-08-16 12:05:01 +02:00
parent 837922aaa7
commit 82f34b2c09
6 changed files with 10 additions and 10 deletions
+1 -1
View File
@@ -27,7 +27,7 @@ Integrations-Backend.
- Keine neuen Laufzeit-Abhängigkeiten ohne Rückfrage (gilt in beiden Teilen). - Keine neuen Laufzeit-Abhängigkeiten ohne Rückfrage (gilt in beiden Teilen).
- Der Notationstext ist das führende Datenformat; kein Teil erfindet ein - Der Notationstext ist das führende Datenformat; kein Teil erfindet ein
eigenes Speicherformat für die Struktur. 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" fertige Funktion beim Mergen **`[x]`**, nicht `[^]`. Auf „in Produktion"
befördert erst der Deploy der stabilen Instanz befördert erst der Deploy der stabilen Instanz
(`scripts/promote-shipped.sh`, von `deploy-prod.sh` aufgerufen) — nur er macht (`scripts/promote-shipped.sh`, von `deploy-prod.sh` aufgerufen) — nur er macht
+1 -1
View File
@@ -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. **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 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 — 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 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 let the deploy promote it. That keeps the plan honest on both instances and
+6 -6
View File
@@ -458,11 +458,11 @@ http(s) erreichbare Textdatei unabhängig von Endung und Content-Type. Es gibt
also keinen Bruch für bestehende Links. also keinen Bruch für bestehende Links.
**Beispieldateien liegen unter `docs/examples/`** (`example-plan-0…3.werkbaum`, **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* sich das Umschalten zwischen Dokumenten (D22) erst mit mehreren *geladenen*
Dokumenten zeigen lässt: jeder `?sourceUrl=`-Link legt ein eigenes Dokument an 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. (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 Weiterentwicklung, destilliert aus ROADMAP/TASKS/DECISIONS) — zugleich
Beispiel und lebende Projektübersicht; bei größeren Änderungen mitpflegen. 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. (`offsetTop`). Gescrollt wird nur, wenn die Zeile nicht ohnehin sichtbar ist.
**Gegenrichtung (Cursor-Zeile → Knoten)** ist bei großen Bäumen die nützlichere **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 verliert man beim Tippen die Orientierung. Der Knoten der Cursor-Zeile bekommt
die Klasse `current`; ins Bild gescrollt wird **nur beim Zeilenwechsel**, sonst die Klasse `current`; ins Bild gescrollt wird **nur beim Zeilenwechsel**, sonst
ruckelte das Diagramm bei jedem Tastendruck. Vor der ersten Cursor-Bewegung ist 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. Projektübersicht.
**Eine Quelle, keine Kopie.** Der Text wird per `?raw`-Import aus **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 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 ein (D19), es wird nichts nachgeladen (D20). Eine zweite, abgetippte Fassung im
Quelltext würde unweigerlich auseinanderlaufen. (Nebenwirkung: die Beispieldatei 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. auf, was genau der Wahrheit entspricht.
**Umfang: genau eine Datei, bewusst kein Muster.** Befördert wird nur **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 etwas über das Deployment aus. `[x]` steht im Repo an mehreren Stellen, wo eine
Beförderung falsch bis unsinnig wäre: 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. gewünschten 2 s — und es ist schlechter als der Knopf, sobald mehrere zuschauen.
Die Alternativen stehen als any-of-Gruppe im mitgelieferten Plan 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 gemessenen Sackgassen als `[-]` mit dem Messergebnis im Kommentar, damit niemand
sie erneut aufmacht. Der günstigste Pfad wählt dort von selbst die sie erneut aufmacht. Der günstigste Pfad wählt dort von selbst die
Rate-Limit-Anhebung — die billigste wirksame Änderung. Rate-Limit-Anhebung — die billigste wirksame Änderung.
+1 -1
View File
@@ -8,7 +8,7 @@ import { padUrls } from './remote.js';
Dieselbe Datei, die auch per ?sourceUrl= geladen werden kann; `?raw` bettet Dieselbe Datei, die auch per ?sourceUrl= geladen werden kann; `?raw` bettet
sie beim Build in die eine Ausgabedatei ein (D19), es wird nichts nachgeladen sie beim Build in die eine Ausgabedatei ein (D19), es wird nichts nachgeladen
(D20). Quelle bleibt docs/examples/ — keine Kopie, die auseinanderläuft. */ (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 const INITIAL = `%% Project structure Sprint 14
[~] Website relaunch (XL) https://wiki.example.com/relaunch [~] Website relaunch (XL) https://wiki.example.com/relaunch
+1 -1
View File
@@ -2,7 +2,7 @@
# #
# Werkbaum — „fertig" auf „in Produktion" befördern. # 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 `[^]` # Werkbaum selbst. SPEC §4 unterscheidet `[x]` fertig (abgeschlossen) von `[^]`
# in Produktion (deployed/live) — und die zweite Aussage kann erst der Deploy # in Produktion (deployed/live) — und die zweite Aussage kann erst der Deploy
# wahr machen. Konvention deshalb: beim Mergen `[x]`, unmittelbar VOR dem # wahr machen. Konvention deshalb: beim Mergen `[x]`, unmittelbar VOR dem