--- doc_type: reference audience: author status: active context: "Zentrales Wörterbuch für Kanten-Bezeichner (Edges). Referenz für Autoren zur Wahl des richtigen Verbindungstyps." --- # Edge Vocabulary & Semantik **Standort:** `01_User_Manual/01_edge_vocabulary.md` **Zweck:** Damit Mindnet "verstehen" kann, was eine Verbindung bedeutet (z.B. für "Warum"-Fragen), nutzen wir konsistente Begriffe. **Die Goldene Regel:** Nutze bevorzugt den **System-Typ** (linke Spalte). Wenn dieser sprachlich nicht passt, nutze einen der **erlaubten Aliasse** (und bleibe dabei konsistent). --- ## 1. Kausalität & Logik ("Warum?") *Verbindungen, die Gründe, Ursachen oder Herleitungen beschreiben.* | System-Typ (Canonical) | Erlaubte Aliasse (User) | Wann nutzen? | | :--- | :--- | :--- | | **`caused_by`** | `ausgelöst_durch`, `wegen`, `ursache_ist` | Wenn A der direkte Auslöser für B ist. (Technisch/Faktisch) | | **`derived_from`** | `abgeleitet_von`, `quelle`, `inspiriert_durch` | Wenn eine Idee/Prinzip aus einer Quelle stammt (z.B. Buch, Zitat). | | **`based_on`** | `basiert_auf`, `fundament`, `grundlage` | Wenn B nicht existieren könnte ohne das fundamentale Konzept A (z.B. Werte). | | **`solves`** | `löst`, `beantwortet`, `fix_für` | Wenn A eine Lösung für das Problem B ist. | ## 2. Struktur & Hierarchie ("Wo gehört es hin?") *Verbindungen, die Ordnung schaffen.* | System-Typ (Canonical) | Erlaubte Aliasse (User) | Wann nutzen? | | :--- | :--- | :--- | | **`part_of`** | `teil_von`, `gehört_zu`, `cluster` | Harte Hierarchie. Projekt A ist Teil von Programm B. | | **`belongs_to`** | *(System-Intern)* | Automatisch generiert (Chunk -> Note). Nicht manuell nutzen. | ## 3. Abhängigkeit & Einfluss ("Was brauche ich?") *Verbindungen, die Blockaden oder Voraussetzungen definieren.* | System-Typ (Canonical) | Erlaubte Aliasse (User) | Wann nutzen? | | :--- | :--- | :--- | | **`depends_on`** | `hängt_ab_von`, `braucht`, `requires`, `enforced_by` | Harte Abhängigkeit. Ohne A kann B nicht starten/existieren. | | **`blocks`** | `blockiert`, `verhindert`, `risiko_für` | Wenn A ein aktives Hindernis für B ist. | | **`uses`** | `nutzt`, `verwendet`, `tool` | Wenn A ein Werkzeug/Methode B einsetzt (z.B. Projekt nutzt Python). | | **`guides`** | `steuert`, `leitet`, `orientierung` | (Alias für `depends_on` oder `related_to`) Weiche Abhängigkeit, z.B. Prinzipien steuern Verhalten. | ## 4. Zeit & Prozess ("Was kommt dann?") *Verbindungen für Abläufe zwischen verschiedenen Notizen.* | System-Typ (Canonical) | Erlaubte Aliasse (User) | Wann nutzen? | | :--- | :--- | :--- | | **`next`** | `danach`, `folgt`, `nachfolger`, `followed_by` | Manuell: Wenn Notiz A logisch vor Notiz B kommt (Prozesskette: A -> B). | | **`prev`** | `davor`, `vorgänger`, `preceded_by` | Manuell: Der vorherige Prozessschritt (B -> A). | ## 5. Assoziation ("Was ist ähnlich?") *Lose Verbindungen für Entdeckungen.* | System-Typ (Canonical) | Erlaubte Aliasse (User) | Wann nutzen? | | :--- | :--- | :--- | | **`related_to`** | `siehe_auch`, `kontext`, `thematisch` | Wenn zwei Dinge etwas miteinander zu tun haben, ohne strikte Logik. | | **`similar_to`** | `ähnlich_wie`, `vergleichbar` | Wenn A und B fast das Gleiche sind (z.B. Synonyme, Alternativen). | | **`references`** | *(Kein Alias)* | Standard für "erwähnt einfach nur". (Niedrigste Prio). | --- ## Best Practices für Autoren ### A. Der "Callout"-Standard (Footer) Sammle Verbindungen, die für die **ganze Notiz** gelten, am Ende der Datei in einem Bereich `## Kontext & Verbindungen`. ```markdown ## Kontext & Verbindungen > [!edge] derived_from > [[Buch der Weisen]] > [!edge] part_of > [[Leitbild – Identity Core]] ``` ### B. Der "Inline"-Standard (Präzision) Nutze Inline-Kanten nur, wenn du im Fließtext eine **spezifische Aussage** triffst, die im Graph sichtbar sein soll. * *Schlecht:* "Das [[rel:related_to Projekt]] ist wichtig." (Wenig Aussagekraft) * *Gut:* "Dieser Fehler wird [[rel:caused_by Systemabsturz]] verursacht." (Starke Kausalität) ### C. Konsistenz-Check Bevor du ein neues Wort (z.B. `ermöglicht`) nutzt: 1. Prüfe diese Liste: Passt `solves` oder `depends_on`? 2. Falls nein: Schreibe `ermöglicht` in die Spalte "Erlaubte Aliasse" oben und ordne es einem System-Typ zu.