diff --git a/docs/DECISIONS.md b/docs/DECISIONS.md index 32a4b34..72a5e92 100644 --- a/docs/DECISIONS.md +++ b/docs/DECISIONS.md @@ -1625,6 +1625,37 @@ der Kandidaten nötig gewesen. - **`°`** — fehlt auf US-Layouts, und der kleine Kreis kollidierte semantisch mit dem hohlen Kreis, der im Diagramm bereits *optional* bedeutet (D29). +**Nachtrag — die Faltmarken sind entschieden: hinter dem Gate, Export folgt +der Faltung.** Die beiden in §11 offenen Fragen zu `>` / `<`: + +**Stellung: hinter dem Zerlegungszeichen, vor der Statusbox** — +`- > [x] Backend`, nicht `> - [x] Backend`. Der Grund ist visuell, nicht +technisch: Die **Spalte der Zerlegungszeichen** ist das, woran das Auge die +Hierarchie abliest. Stünde `>` davor, rückte das `-` der gefalteten Zeile +gegenüber seinen Geschwistern um zwei Zeichen ein — die Gate-Spalte zerfiele +genau an den Stellen, die man gerade aufgeräumt hat. Hinter dem Gate +verschiebt sich nur die Statusbox, und die trägt keine +Ausrichtungs-Information. Dazu kommt: `>` am Zeilenanfang ist die +Markdown-Blockquote-Konvention und würde falsch gelesen (dieselbe Sorte +Kollision, wegen der D29 `*` verwarf — Markdown-Betonung). Wurzelknoten haben +kein Gate — dort steht die Marke am Zeilenanfang; Wurzeln sind selten, und +die Regel „hinter dem Zeichen“ bleibt trotzdem einheitlich formulierbar. + +**Export und Druck folgen der sichtbar eingeklappten Struktur — mit +Kennzeichnung.** Der Präzedenzfall steht in §9: „Es wird genau die sichtbare +Struktur exportiert (der ‚verworfene einblenden‘-Filter wirkt auch hier).“ +Dieselbe Regel für die Faltung ist konsistent und praktisch richtig: Wer für +eine Präsentation die Detailebenen zuklappt, will genau dieses Bild teilen. +Der geprüfte Einwand: Der interaktive Faltzustand ist *persönlicher* +Ansichtszustand, und Persönliches (Cursor-Ring, gelber Kranz, Fokusmarke — +D25/D28/D32) wird bewusst **nicht** exportiert. Der Unterschied: Jene Marken +sagen „schau hin“ bzw. „für dich neu“ — eine Aussage über den Betrachter. +Faltung sagt „diese Detailtiefe“ — eine Aussage über das Bild, das der +Exportierende zeigen will. Damit das Bild dabei nicht lügt, wird ein +eingeklappter Knoten sichtbar gekennzeichnet (etwa „▸“ oder die Anzahl der +verborgenen Kinder); die genaue Form entscheidet sich beim Bauen, die +SPEC-Aussage ist nur: sichtbare Struktur, Einklappung gekennzeichnet. + ## D35 — XOR (`=`) umgesetzt: „realisiert“ definiert, „1“-Plakette, keine neue Linienart Das in D34 entschiedene XOR-Gate ist gebaut (SPEC §1/§3/§9); beim Bauen waren drei Dinge zu entscheiden, die die SPEC bis dahin offen ließ: diff --git a/docs/ROADMAP.md b/docs/ROADMAP.md index 36902a0..dd7fb6b 100644 --- a/docs/ROADMAP.md +++ b/docs/ROADMAP.md @@ -161,7 +161,9 @@ Pfad, der die Wahrheit sagt. - **Ein- und ausklappbare Teilbäume** (`>` / `<`). Sobald Pläne quer verbunden sind, wächst das Diagramm über den Bildschirm hinaus; ohne Falten ist ein großer Plan nicht mehr zu lesen. Die Marken im Text bestimmen nur den - Anfangszustand — im Diagramm wird danach unabhängig gefaltet. + Anfangszustand — im Diagramm wird danach unabhängig gefaltet. Schreibweise + und Export-Verhalten sind entschieden (D34-Nachtrag): `- > [x] …`, + Export/Druck folgen der sichtbaren Faltung mit Kennzeichnung. Der gestaffelte „günstigste Pfad" aus *Kleinere Ideen* (Status-Bewusstsein, Ausbaustufen) baut hierauf auf: Er braucht denselben Umbau der Kostenrechnung diff --git a/docs/SPEC.md b/docs/SPEC.md index 5f1e97a..48e7f32 100644 --- a/docs/SPEC.md +++ b/docs/SPEC.md @@ -654,9 +654,17 @@ die Rechnung schwerer als heute — siehe D34. gezielt wieder hervor. - Im Diagramm wird danach **unabhängig vom Text** interaktiv auf- und zugeklappt; die Marken im Text bestimmen nur den Anfangszustand. -- **Offen:** die Stellung im Zeilenformat (§1) — vor oder hinter dem - Zerlegungszeichen — und ob eingeklappte Teilbäume in Grafikexport und Druck - eingeklappt bleiben. +- **Stellung im Zeilenformat (entschieden):** **hinter** dem Zerlegungszeichen, + vor der Statusbox — `- > [x] Backend`. Die Spalte der Zerlegungszeichen + bleibt so bündig (an ihr liest das Auge die Hierarchie ab), und ein `>` am + Zeilenanfang wäre die Markdown-Blockquote-Konvention. Wurzelknoten (ohne + Zeichen) tragen die Marke am Zeilenanfang. Begründung: D34-Nachtrag. +- **Grafikexport und Druck (entschieden):** folgen der **sichtbar + eingeklappten** Struktur — dieselbe Regel wie beim „verworfene + einblenden“-Filter (§9: „Es wird genau die sichtbare Struktur exportiert“). + Damit das Bild nicht stillschweigend Vollständigkeit behauptet, wird ein + eingeklappter Knoten **gekennzeichnet** (z. B. „▸“ oder die Anzahl der + verborgenen Kinder; genaue Form wird beim Bauen festgelegt). ### Knotenbeschreibungen diff --git a/docs/TASKS.md b/docs/TASKS.md index f9862da..9f73be0 100644 --- a/docs/TASKS.md +++ b/docs/TASKS.md @@ -92,6 +92,9 @@ entscheiden, **bevor** Code entsteht. - [ ] Querverbindungen zeichnen (eigene SVG-Ebene, optisch sekundär); bei ausgewähltem Knoten ein-/ausgehende hervorheben. - [ ] Faltmarken `>` / `<` parsen; interaktives Auf-/Zuklappen im Diagramm. + → Schreibweise und Export-Verhalten entschieden (D34-Nachtrag): Marke + hinter dem Zerlegungszeichen (`- > [x] …`), Export/Druck folgen der + sichtbar eingeklappten Struktur mit Kennzeichnung am Knoten. - [x] XOR-Gruppe (`=`) parsen (nur mit folgendem Leerraum, Mischung → `mixedGate`), zwei realisierte Alternativen melden. → Zeichen entschieden: `=` statt `x` (D34-Nachtrag). Umgesetzt (D35):