docs: Faltmarken entschieden — hinter dem Gate, Export folgt der Faltung (D34-Nachtrag)

Stellung: `- > [x] Backend` — die Marke steht hinter dem Zerlegungszeichen,
damit die Gate-Spalte bündig bleibt (an ihr liest das Auge die Hierarchie
ab); `>` am Zeilenanfang wäre zudem die Markdown-Blockquote-Konvention.
Wurzelknoten ohne Zeichen tragen die Marke am Zeilenanfang.

Grafikexport und Druck folgen der sichtbar eingeklappten Struktur (wie der
Verworfene-Filter, SPEC §9); eingeklappte Knoten werden gekennzeichnet,
damit das Bild nicht stillschweigend Vollständigkeit behauptet — anders als
Cursor-Ring/Kranz/Fokusmarke ist die Faltung eine Aussage über das Bild,
nicht über den Betrachter. Genaue Form der Kennzeichnung beim Bauen.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
mhoennig
2026-08-22 16:26:40 +02:00
co-authored by Claude Fable 5
parent 3ba37fc5a0
commit c778e3e267
4 changed files with 48 additions and 4 deletions
+31
View File
@@ -1625,6 +1625,37 @@ der Kandidaten nötig gewesen.
- **`°`** — fehlt auf US-Layouts, und der kleine Kreis kollidierte semantisch - **`°`** — fehlt auf US-Layouts, und der kleine Kreis kollidierte semantisch
mit dem hohlen Kreis, der im Diagramm bereits *optional* bedeutet (D29). 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 ## 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 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ß: drei Dinge zu entscheiden, die die SPEC bis dahin offen ließ:
+3 -1
View File
@@ -161,7 +161,9 @@ Pfad, der die Wahrheit sagt.
- **Ein- und ausklappbare Teilbäume** (`>` / `<`). Sobald Pläne quer verbunden - **Ein- und ausklappbare Teilbäume** (`>` / `<`). Sobald Pläne quer verbunden
sind, wächst das Diagramm über den Bildschirm hinaus; ohne Falten ist ein 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 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, Der gestaffelte „günstigste Pfad" aus *Kleinere Ideen* (Status-Bewusstsein,
Ausbaustufen) baut hierauf auf: Er braucht denselben Umbau der Kostenrechnung Ausbaustufen) baut hierauf auf: Er braucht denselben Umbau der Kostenrechnung
+11 -3
View File
@@ -654,9 +654,17 @@ die Rechnung schwerer als heute — siehe D34.
gezielt wieder hervor. gezielt wieder hervor.
- Im Diagramm wird danach **unabhängig vom Text** interaktiv auf- und - Im Diagramm wird danach **unabhängig vom Text** interaktiv auf- und
zugeklappt; die Marken im Text bestimmen nur den Anfangszustand. zugeklappt; die Marken im Text bestimmen nur den Anfangszustand.
- **Offen:** die Stellung im Zeilenformat (§1) — vor oder hinter dem - **Stellung im Zeilenformat (entschieden):** **hinter** dem Zerlegungszeichen,
Zerlegungszeichen — und ob eingeklappte Teilbäume in Grafikexport und Druck vor der Statusbox — `- > [x] Backend`. Die Spalte der Zerlegungszeichen
eingeklappt bleiben. 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 ### Knotenbeschreibungen
+3
View File
@@ -92,6 +92,9 @@ entscheiden, **bevor** Code entsteht.
- [ ] Querverbindungen zeichnen (eigene SVG-Ebene, optisch sekundär); - [ ] Querverbindungen zeichnen (eigene SVG-Ebene, optisch sekundär);
bei ausgewähltem Knoten ein-/ausgehende hervorheben. bei ausgewähltem Knoten ein-/ausgehende hervorheben.
- [ ] Faltmarken `>` / `<` parsen; interaktives Auf-/Zuklappen im Diagramm. - [ ] 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 → - [x] XOR-Gruppe (`=`) parsen (nur mit folgendem Leerraum, Mischung →
`mixedGate`), zwei realisierte Alternativen melden. `mixedGate`), zwei realisierte Alternativen melden.
→ Zeichen entschieden: `=` statt `x` (D34-Nachtrag). Umgesetzt (D35): → Zeichen entschieden: `=` statt `x` (D34-Nachtrag). Umgesetzt (D35):