diff --git a/docs/01_User_Manual/01_knowledge_design.md b/docs/01_User_Manual/01_knowledge_design.md index ef755e0..4ee9925 100644 --- a/docs/01_User_Manual/01_knowledge_design.md +++ b/docs/01_User_Manual/01_knowledge_design.md @@ -130,6 +130,46 @@ Wähle den Typ, der die **Rolle** der Notiz am besten beschreibt. Der Typ setzt 1. **Ideenfindung:** Setzen Sie neue Ideen immer auf **`draft`**. So können Sie frei schreiben, ohne dass die KI sofort "Halbwissen" als Fakten verkauft. 2. **Finalisierung:** Sobald eine Entscheidung getroffen oder ein Konzept fertig ist, ändern Sie den Status auf **`stable`**. 3. **Konfiguration:** Nutzen Sie **`system`** für Dateien wie die `01_edge_vocabulary.md`, damit die KI nicht die Definition der Kanten zitiert, wenn Sie eigentlich nach Inhalten suchen. + +### 3.3 Aliases (Synonyme & Verlinkung) + +Das optionale Feld `aliases` erlaubt es dir, einer Notiz alternative Titel oder Synonyme zu geben. Dies ist ein mächtiges Werkzeug für die Usability und die Suche. + +```yaml +--- +title: Leitbild – Handlungsprinzipien +aliases: [Prinzipien, Handlungsleitlinien, Entscheidungsprinzipien] +--- + +Warum Aliases nutzen? +1. Flüssigeres Schreiben in Obsidian: Du kannst auf die Notiz verlinken, ohne den sperrigen Haupttitel zu nutzen. +- Statt: Wir müssen unsere [[Leitbild – Handlungsprinzipien]] beachten. +- Schreibst du: Wir müssen unsere [[Handlungsleitlinien]] beachten. (Obsidian löst dies korrekt auf). +2. Bessere Auffindbarkeit in Mindnet: Aliases erweitern den "Suchradius" einer Notiz. Wenn du im Chat nach "Entscheidungsprinzipien" fragst, findet Mindnet diese Notiz, auch wenn das Wort im eigentlichen Text oder Titel gar nicht vorkommt. Es fungiert als semantischer Anker. + +**Best Practices für Aliases** + +Damit dein System sauber bleibt, beachte diese Regeln: + +* ✅ **Akronyme & Abkürzungen:** + Nutze Aliases für technische Kürzel. + * *Note:* `Retrieval Augmented Generation` + * *Alias:* `[RAG, RAG-Architektur]` + * *Vorteil:* Du tippst im Fließtext nur `[[RAG]]` und bist fertig. + +* ✅ **Projekt-Codenamen:** + Verbinde den offiziellen Titel mit dem Flur-Namen. + * *Note:* `Projekt Phoenix – Cloud Migration` + * *Alias:* `[Phoenix, Cloud-Projekt]` + +* ❌ **Vermeide generische Begriffe (Namespace Pollution):** + Gib einer spezifischen Notiz niemals einen Alias, der ein allgemeines Wort ist. + * *Schlecht:* Alias `[Meeting]` für `2025-10-JourFixe`. + * *Folge:* Jedes Mal, wenn du das Wort "Meeting" tippst, schlägt Obsidian dir diesen einen alten Jour Fixe vor. Das zerstört den Schreibfluss. + +* ❌ **Keine Plural-Wahn:** + Mindnet und Obsidian finden meist auch den Plural (Fuzzy Search). Du musst nicht `[Prinzip, Prinzipien, Prinzips]` anlegen. Ein Stammbegriff reicht oft. + --- ## 4. Edges & Verlinkung