rename: example-werkbaum.werkbaum zu werkbaum.werkbaum.
This commit is contained in:
@@ -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
|
||||||
|
|||||||
@@ -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
@@ -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
@@ -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
|
||||||
|
|||||||
@@ -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
|
||||||
|
|||||||
Reference in New Issue
Block a user