Glossar

Das Glossar ist eine zentrale Referenz für standardisierte Fachbegriffe, die deine Dokumentation sprachlich konsistent hält. Es enthält genehmigte Begriffe, ihre Definitionen und Varianten, die du vermeiden solltest, damit alle, die Artikel schreiben, die gleiche Ausdrucksweise verwenden.

Wofür es da ist

Ohne ein Glossar erscheint das gleiche Produkt oder Konzept in verschiedenen Formen in deinen Artikeln. Ein Autor schreibt vielleicht "HappySupport", ein anderer "Happy Support" und ein dritter "happysupport". Das Glossar legt eine bevorzugte Form pro Begriff fest und macht die falschen Varianten deutlich. So vermeidest du Begriffsdrift und reduzierst Verwirrung in deinen Support-Inhalten.

Teams, die große Help Center betreiben, SaaS-Produkte mit eigener Fachterminologie oder mehrsprachige Dokumentation verwalten, 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, um zu verdeutlichen, was der Begriff nicht bedeutet.
• Beispiel (optional): ein Satz, der die korrekte Verwendung im Kontext zeigt.

Das Feld "Negativ" macht das Glossar praktisch anwendbar: Wenn du "HappySupport" als Begriff mit "Happy Support" als Negativ kombinierst, wird Autoren sofort klar, welche Variante richtig und welche falsch ist.

Für Help-Center-spezifische Einträge kannst du auch Übersetzungen des Begriffs für jede Sprache hinzufügen, die dein Help Center unterstützt. So bleibt die Terminologie konsistent, 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 verwendet. Sie erscheinen in jedem Help Center und können nur auf der Glossar-Seite auf Organisationsebene verwaltet werden. Wenn du das Glossar eines Help Centers anschaust, erscheinen globale Einträge als schreibgeschützte Zeilen, 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 verschmelzen mit den geerbten globalen Einträgen in der Glossar-Ansicht des Help Centers. Nur diese Einträge können aus dem Help Center heraus bearbeitet werden.

Wie es in das Produkt passt

Das Glossar erreichst du an zwei Stellen. Die Glossar-Seite auf Organisationsebene verwaltet globale Einträge, die überall gelten. In den Einstellungen jedes Help Centers zeigt ein dediziertes Glossar-Panel sowohl globale Einträge (schreibgeschützt) als auch Help-Center-spezifische Einträge zusammen an, mit einem Bereichs-Umschalter zum Wechsel zwischen den Ansichten.

Wenn du einen Eintrag hinzufügst oder bearbeitest, öffnet sich ein Modal, in dem du den Bereich wählst, den Begriff und die Definition ausfüllst und optional negative Beispiele, positive Beispiele und Übersetzungen hinzufügst. Das Feld "Definition" hat einen KI-gestützten Assist-Button, der auf Basis des Begriffs und des Help-Center-Kontexts eine Definition generieren kann.