docs: Schlagworte auf &tag umreserviert, #-Doppelrolle aufgelöst (D34)
Tickets haben auf `#` Vorrang (`#123` als etablierte Kurzschreibweise, oft zugleich die natürliche Knoten-ID; notfalls Präfix wie `#t123`). Freie Schlagworte verlassen `#` und gehen auf `&tag` — als niedrig priorisierte Idee, ausdrücklich ungebaut: Ohne Konsumenten (Filter-Linse, Taiga-Label-Sync) sind Tags nur Kommentare mit Extra-Syntax; gebaut erst zusammen mit dem ersten. Zeichenwahl nach den D32-Kriterien: `&` ist auf DE- wie US-Layout eine Shift-Taste, nie ein Dead-Key; „R&D" und „Drag & Drop" bleiben durch die Alleinstehend-Regel (wie `!!!`) Labels. Verworfen: `~` (Dead-Key auf Mac-DE, Zirka-Kollision), `$`, `%`, `:`, `§`, `*`. Damit ist der offene Punkt aus D34 durch Wegfall statt Trennregel geschlossen. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
co-authored by
Claude Fable 5
parent
90230c4dd3
commit
477ef6c812
@@ -1545,3 +1545,32 @@ mit `:#id` überholt — ein Verweis auf den Titel bricht beim Umbenennen, und R
|
|||||||
ist in dieser Palette nicht vergeben (SPEC §4 nutzt Pastelltöne für Status,
|
ist in dieser Palette nicht vergeben (SPEC §4 nutzt Pastelltöne für Status,
|
||||||
`--warn` für Hinweise). Die Datei ist entsprechend korrigiert; die dortigen
|
`--warn` für Hinweise). Die Datei ist entsprechend korrigiert; die dortigen
|
||||||
Phasen bleiben, was sie sind: eine Wunschliste, kein Beschluss.
|
Phasen bleiben, was sie sind: eine Wunschliste, kein Beschluss.
|
||||||
|
|
||||||
|
**Nachtrag — die `#`-Doppelrolle ist aufgelöst, durch Wegfall statt Trennregel.**
|
||||||
|
Entschieden: **Ticket-Referenzen haben auf `#` Vorrang** — `#123` ist die
|
||||||
|
etablierte Kurzschreibweise, und oft ist die Ticket-Nummer ohnehin die
|
||||||
|
natürliche Knoten-ID; die beiden Rollen vertragen sich (numerisch = Ticket als
|
||||||
|
Heuristik, notfalls Präfix-Konvention wie `#t123`). Knifflig bleibt allein das
|
||||||
|
heuristische Erzeugen von Taiga-Links — das ist benannt und liegt beim
|
||||||
|
Taiga-Spike.
|
||||||
|
|
||||||
|
**Freie Schlagworte verlassen `#` und gehen auf `&tag`** — als **niedrig
|
||||||
|
priorisierte Idee**, ausdrücklich ungebaut. Der Schritt zurück („wofür brauchen
|
||||||
|
wir überhaupt Tags?") ergab: Es gibt bisher keinen Konsumenten. Die
|
||||||
|
Reservierung stammt aus D7 als Beifang der Kommentarzeichen-Entscheidung; kein
|
||||||
|
geplantes Feature wertet Schlagworte aus. Ihr einziges echtes Argument ist,
|
||||||
|
dass der Baum genau **eine** Zerlegung ist — ein Tag benennt eine **Menge** von
|
||||||
|
Knoten quer dazu (die ID benennt einen, Abhängigkeiten verbinden Paare). Ohne
|
||||||
|
Auswerter (Filter-/Hervorheben-Linse im Diagramm, Taiga-Label-Sync) sind Tags
|
||||||
|
nur Kommentare mit Extra-Syntax; `%% frontend` sagt dem Leser heute dasselbe.
|
||||||
|
Gebaut werden sie deshalb erst **zusammen mit** dem ersten Konsumenten.
|
||||||
|
|
||||||
|
Zeichenwahl `&` nach den D32-Kriterien (schnell zu tippen, kollisionsfrei,
|
||||||
|
keine Markdown-Bedeutung): Shift-Taste auf DE- wie US-Layout, nie ein Dead-Key
|
||||||
|
— anders als `~`, das auf deutschen Macs hinter Alt+N klemmt und mit
|
||||||
|
Zirka-Angaben („~3 Wochen") kollidiert. „R&D" und „Drag & Drop" bleiben durch
|
||||||
|
die Alleinstehend-Regel (wie `!!!`) Labels. Der Einwand „`&` heißt und" trägt
|
||||||
|
nicht: Das Und der Notation ist `-` am Zeilenanfang — `&` ist gerade deshalb
|
||||||
|
frei. Verworfen: `$` (Preis-Kollision), `%` (ein Tippfehler vom
|
||||||
|
Auskommentieren), `:` (zu nah an `:#…`), `§` (fehlt auf US-Tastaturen), `*`
|
||||||
|
(Markdown, schon in D29 verworfen).
|
||||||
|
|||||||
@@ -104,6 +104,13 @@ Tastendruck ein Commit); und wer bei einem Backend eigentlich was darf
|
|||||||
erweitert D18 (heute rein statisch/kostenminimierend) um Nutzen- und
|
erweitert D18 (heute rein statisch/kostenminimierend) um Nutzen- und
|
||||||
Status-/Zeitachse.
|
Status-/Zeitachse.
|
||||||
- Attribut-Syntax für Termine/Meilensteine.
|
- Attribut-Syntax für Termine/Meilensteine.
|
||||||
|
- Schlagworte `&tag` mit einer Filter-/Hervorheben-Linse im Diagramm: Der Baum
|
||||||
|
ist genau eine Zerlegung — ein Tag benennt eine Menge von Knoten quer dazu
|
||||||
|
(z. B. `&frontend` in feature-geschnittenen Slices). Schreibweise reserviert
|
||||||
|
(SPEC §11, D34-Nachtrag); bewusst erst zusammen mit dem ersten Konsumenten
|
||||||
|
bauen (Linse oder Taiga-Label-Sync) — ohne Auswerter sind Tags nur
|
||||||
|
Kommentare mit Extra-Syntax. Die Inversions-Mechanik der Linse gibt es durch
|
||||||
|
den günstigsten Pfad (D18) schon.
|
||||||
|
|
||||||
## Vollständiges Lean-Pathfinding
|
## Vollständiges Lean-Pathfinding
|
||||||
|
|
||||||
|
|||||||
+21
-8
@@ -508,21 +508,34 @@ anderweitig verwenden** — nicht: schon entschieden. Die endgültige Schreibwei
|
|||||||
wird hier festgelegt, **bevor** sie gebaut wird; wo unten „offen“ steht, ist sie
|
wird hier festgelegt, **bevor** sie gebaut wird; wo unten „offen“ steht, ist sie
|
||||||
das auch. Begründung und Zusammenhang: D34.
|
das auch. Begründung und Zusammenhang: D34.
|
||||||
|
|
||||||
### Referenzen, Schlagworte und Knoten-IDs (`#`)
|
### Referenzen und Knoten-IDs (`#`)
|
||||||
|
|
||||||
- `#123` — Referenz auf externe Tickets (geplant für Taiga-Integration).
|
- `#123` — Referenz auf externe Tickets (geplant für Taiga-Integration).
|
||||||
- `#tag` — freie Schlagworte.
|
Ticket-Referenzen werden **so** notiert, weil es die etablierte
|
||||||
|
Kurzschreibweise ist; sie haben unter den `#`-Verwendungen Vorrang.
|
||||||
- `#auth` — **Knoten-ID**: ein whitespace-freier Bezeichner, der einen Knoten im
|
- `#auth` — **Knoten-ID**: ein whitespace-freier Bezeichner, der einen Knoten im
|
||||||
ganzen Dokument eindeutig benennt. Ziel für Abhängigkeiten und
|
ganzen Dokument eindeutig benennt. Ziel für Abhängigkeiten und
|
||||||
Beschreibungsblöcke (siehe unten). Zwei Knoten mit derselben ID sind ein
|
Beschreibungsblöcke (siehe unten). Zwei Knoten mit derselben ID sind ein
|
||||||
Fehler und bekommen eine Warnung mit Zeilennummer (§4).
|
Fehler und bekommen eine Warnung mit Zeilennummer (§4).
|
||||||
|
|
||||||
**Offen: `#` trägt damit drei Bedeutungen.** `#123` ist rein numerisch und
|
Beide Rollen vertragen sich: Oft **ist** die Ticket-Nummer die natürliche
|
||||||
bleibt unterscheidbar; **ID und Schlagwort sehen einander gleich**. Vor der
|
Knoten-ID. Als Ticket-Link behandelt wird heuristisch das rein **numerische**
|
||||||
Implementierung ist eine Trennregel zu entscheiden — etwa „das erste
|
`#123`; wo das nicht reicht, schafft eine Präfix-Konvention (z. B. `#t123`)
|
||||||
`#`-Token einer Zeile ist die ID, jedes weitere ein Schlagwort“ oder ein
|
Eindeutigkeit. Freie Schlagworte liegen **nicht** mehr auf `#` — siehe `&tag`
|
||||||
eigenes Zeichen für eine der beiden Rollen. Solange das offen ist, ist auch
|
unten; damit ist die frühere Dreifach-Rolle von `#` aufgelöst (D34).
|
||||||
`#tag` nicht gebaut.
|
|
||||||
|
### Schlagworte (`&tag`) — reserviert, bewusst ungebaut
|
||||||
|
|
||||||
|
- `&tag` — freies Schlagwort: benennt eine **Menge** von Knoten quer zur
|
||||||
|
Hierarchie (die ID benennt genau einen). Mehrere pro Zeile, Position egal,
|
||||||
|
gleiche Zeichenmenge wie `@name` (§7: Unicode-Buchstaben, Ziffern, `.`,
|
||||||
|
`_`, `-`).
|
||||||
|
- Erkannt nur **alleinstehend** angesetzt (`(^|\s)&\w`, wie `!!!` in §1) —
|
||||||
|
„R&D“ und „Drag & Drop“ bleiben damit gewöhnliche Labels.
|
||||||
|
- **Niedrig priorisiert:** Ohne ein Feature, das Schlagworte auswertet
|
||||||
|
(Filter-/Hervorheben-Linse, Taiga-Label-Sync), sind sie nur Kommentare mit
|
||||||
|
Extra-Syntax — gebaut werden sie erst **zusammen mit** dem ersten solchen
|
||||||
|
Konsumenten. Bis dahin gilt allein: `&` nicht anderweitig vergeben.
|
||||||
|
|
||||||
### Abhängigkeiten zwischen Knoten (`:#auth,#api`)
|
### Abhängigkeiten zwischen Knoten (`:#auth,#api`)
|
||||||
|
|
||||||
|
|||||||
+5
-2
@@ -66,8 +66,11 @@ Reihenfolge ist nicht beliebig: ohne IDs keine Abhängigkeiten, ohne die keinen
|
|||||||
effektiven Status und keine Closure-Rechnung. Jeder Punkt beginnt in
|
effektiven Status und keine Closure-Rechnung. Jeder Punkt beginnt in
|
||||||
[SPEC §11](SPEC.md) — die dort benannten offenen Schreibweisen sind zu
|
[SPEC §11](SPEC.md) — die dort benannten offenen Schreibweisen sind zu
|
||||||
entscheiden, **bevor** Code entsteht.
|
entscheiden, **bevor** Code entsteht.
|
||||||
- [ ] `#`-Doppelrolle auflösen (Knoten-ID vs. Schlagwort) und in SPEC §11
|
- [x] `#`-Doppelrolle auflösen und in SPEC §11 festschreiben.
|
||||||
festschreiben; `#tag` hängt an derselben Entscheidung.
|
→ Durch Wegfall statt Trennregel: Tickets haben Vorrang (`#123`
|
||||||
|
numerisch, oft zugleich die natürliche Knoten-ID; notfalls Präfix wie
|
||||||
|
`#t123`); Schlagworte gehen auf `&tag` — niedrig priorisiert, gebaut
|
||||||
|
erst mit dem ersten Konsumenten (D34-Nachtrag).
|
||||||
- [ ] Knoten-IDs parsen; doppelte ID → Warnung mit Zeilennummer.
|
- [ ] Knoten-IDs parsen; doppelte ID → Warnung mit Zeilennummer.
|
||||||
- [ ] Abhängigkeiten `:#a,#b` parsen; unbekannte ID → Warnung, Zyklen erlaubt.
|
- [ ] Abhängigkeiten `:#a,#b` parsen; unbekannte ID → Warnung, Zyklen erlaubt.
|
||||||
- [ ] Effektiven Status rechnen (intrinsisch + Abhängigkeiten); Darstellung
|
- [ ] Effektiven Status rechnen (intrinsisch + Abhängigkeiten); Darstellung
|
||||||
|
|||||||
@@ -9,7 +9,9 @@
|
|||||||
- [^] People tags, bare URLs, %% comments (XS)
|
- [^] People tags, bare URLs, %% comments (XS)
|
||||||
- [^] And/or decomposition (S)
|
- [^] And/or decomposition (S)
|
||||||
- [^] Optional nodes — neither required nor an alternative (S)
|
- [^] Optional nodes — neither required nor an alternative (S)
|
||||||
- [?] Node IDs, #auth (S) %% but # already means tickets and tags, see SPEC §11
|
- [?] Node IDs, #auth (S) %% often just the ticket number, see SPEC §11
|
||||||
|
+ [?] Free tags, &tag (M) %% only together with a consumer, see D34
|
||||||
|
- [?] A lens: highlight every node tagged &x (S)
|
||||||
- [?] Dependencies across the tree, :#auth,#api (M)
|
- [?] Dependencies across the tree, :#auth,#api (M)
|
||||||
- [?] They constrain the status, not when work may start (S)
|
- [?] They constrain the status, not when work may start (S)
|
||||||
- [?] Effective status: intrinsic, plus what it depends on (S)
|
- [?] Effective status: intrinsic, plus what it depends on (S)
|
||||||
|
|||||||
Reference in New Issue
Block a user