Glossar: Standardisierte Terminologie-Referenz

Das Glossar ist deine zentrale Anlaufstelle für standardisierte Terminologie und sorgt dafür, dass die Sprache in deiner gesamten Dokumentation einheitlich bleibt. Es enthält genehmigte Begriffe, ihre Definitionen und Varianten, die du vermeiden solltest, damit alle, die Artikel schreiben, die gleiche Ausdrucksweise verwenden.

Wofür ist es gut

Ohne ein Glossar taucht das gleiche Produkt oder Konzept in deinen Artikeln in verschiedenen Formen auf. Der eine Autor schreibt vielleicht "HappySupport", der andere "Happy Support" und ein dritter "happysupport". Das Glossar legt eine bevorzugte Form pro Begriff fest und macht die falschen Varianten explizit, wodurch Terminologie-Drift verhindert wird und Verwirrung in deinen Support-Inhalten sinkt.

Teams, die große Help Center verwalten, SaaS-Produkte mit eigenem Vokabular oder mehrsprachige Dokumentation pflegen, nutzen das Glossar, um Konsistenz im großen Maßstab zu bewahren.

Was ein Glossar-Eintrag enthält

Jeder Eintrag hat vier Felder:

• Begriff: die bevorzugte Ausdrucksweise, die alle verwenden sollten.
• Definition: was der Begriff bedeutet.
• Negativ (optional): eine Ausdrucksweise, die du vermeiden solltest, und die verdeutlicht, was der Begriff nicht bedeutet.
• Beispiel (optional): ein Satz, der die korrekte Verwendung im Kontext zeigt.

Das Feld "Negativ" macht das Glossar handlungsfähig: Wenn du "HappySupport" als Begriff mit "Happy Support" als Negativ verbindest, zeigst du deinen Autoren, welche Variante richtig ist und welche nicht.

Für Help Center-spezifische Einträge kannst du auch Übersetzungen des Begriffs selbst in jede Sprache hinzufügen, die dein Help Center unterstützt. Das sorgt dafür, dass die Terminologie konsistent bleibt, wenn Artikel in verschiedenen Sprachen angezeigt werden.

Wie Einträge strukturiert sind

Das Glossar arbeitet in zwei Bereichen:

Globale Einträge werden in deiner gesamten Organisation gemeinsam genutzt. Sie tauchen in jedem Help Center auf und können nur von der Glossar-Seite auf Organisationsebene verwaltet werden. Wenn du das Glossar eines Help Center anschaust, werden globale Einträge als schreibgeschützte Zeilen angezeigt, die in diesem Kontext nicht bearbeitet oder gelöscht werden können.

Help Center-spezifische Einträge gelten nur für ein einzelnes Help Center. Sie unterstützen Übersetzungen pro Sprache und werden im Glossar-View des Help Center mit geerbten globalen Einträgen kombiniert. Nur diese Einträge kannst du von innerhalb des Help Center aus bearbeiten.

Wie es sich in das Produkt einfügt

Das Glossar ist an zwei Stellen erreichbar. Die Glossar-Seite auf Organisationsebene verwaltet globale Einträge, die überall gelten. In den Einstellungen jedes Help Center zeigt ein eigenes Glossar-Panel sowohl globale Einträge (schreibgeschützt) als auch Help Center-spezifische Einträge zusammen an, mit einem Bereichs-Toggle, um zwischen den Ansichten zu wechseln.

Wenn du einen Eintrag hinzufügst oder bearbeitest, kannst du in einem Modal den Bereich auswählen, den Begriff und die Definition ausfüllen und optional negative Beispiele, positive Beispiele und Übersetzungen hinzufügen. Das Definitionsfeld enthält einen KI-gestützten Assist-Button, der eine Definition basierend auf dem Begriff und dem Help Center-Kontext generieren kann.