User Documentation Dieses Glossar definiert standardisierte Begriffe und Formulierungen, die in der Dokumentation und in Tutorials verwendet werden, um die Terminologie und Wortwahl zwischen den Autoren konsistent zu halten.
Anmelden vs. Anmeldung
Die Regel: Login (ein Wort) ist ein Substantiv oder Adjektiv; log in (zwei Wörter) ist das Verb.
- Substantiv/Adjektiv: „the login screen“, „the login button“, „your login credentials“, „a failed login“ — überall dort, wo es ein Ding benennt oder ein anderes Substantiv beschreibt, ist es ein Wort.
- Verb: „please log in“, „log in with your email“, „you need to log in first“ — überall dort, wo es die Handlung des Einloggens beschreibt, sind es zwei Wörter.
Beispiel: „Go to the login screen, then log in, then click the login button.“
Das gleiche Muster gilt für logout/log out: „the logout button“ (Substantiv/Adjektiv, ein Wort) vs. „log out when you're done“ (Verb, zwei Wörter).
Die Website ansehen
Verwende „die Website ansehen“, um einen Benutzer, der im Backend arbeitet, anzuweisen, das Frontend zu öffnen und die Ergebnisse der gerade vorgenommenen Änderungen zu überprüfen.
Die Aktion nutzt den Link Vorschau in der Kopfzeile des Backends, der das Frontend in einem neuen Browser-Tab öffnet. Dadurch entsteht ein Zwei-Tab-Workflow: das Backend in einem Tab, das Frontend im anderen, wobei der Benutzer zwischen beiden wechselt, um Ergebnisse zu überprüfen. Dieses Muster sollte früh eingeführt werden — in der Einleitung des Tutorials —, damit sich die Benutzer daran gewöhnen, in den nachfolgenden Tutorials zwischen den Tabs zu wechseln.
Beispiel: „In der Kopfzeile des Backends auf Vorschau klicken, um das Frontend in einem neuen Tab zu öffnen. Beide Tabs geöffnet lassen und während dieses Tutorials zwischen ihnen wechseln.“
Administrator-Menü
Das Navigationsmenü auf der linken Seite im Verwaltungsbereich der Website wird Administrator-Menü genannt.
Frontend / Backend
Verwende „Frontend“, um sich auf die öffentlich zugängliche Website zu beziehen, und „Backend“, um sich auf den Verwaltungsbereich zu beziehen. Diese entsprechen dem, was Joomlas eigene Dokumentation „die Site“ bzw. „der Administrator“ nennt.
Bevorzuge Frontend/Backend in Tutorial-Anweisungen, insbesondere wenn der Leser angewiesen wird, sich bei einem der beiden Bereiche anzumelden — es liest sich als kontrastierendes Paar natürlicher. Verwende Site/Administrator nur, wenn auf Joomlas eigene offizielle Einstellungen oder Menübezeichnungen Bezug genommen wird, bei denen genau diese Begriffe auftauchen (z. B. Site Module vs. Administrator Module).
Ziehpunkt
Verwende „Drag Handle“ für das Symbol (drei senkrechte Punkte), das in Backend-Listenansichten zum Umordnen von Einträgen erscheint — Beiträge, Menüeinträge, Module, Kategorien und ähnliche Listen unterstützen dies alle. Es erscheint, nachdem auf das Pfeil-Symbol (auf/ab) in der entsprechenden Spaltenüberschrift geklickt wurde, und nur dann, wenn die Liste so gefiltert oder sortiert ist, dass eine Reihenfolge möglich ist.
Joomlas eigener Quellcode bezeichnet dies intern als „sortable handler“ (CSS-Klasse sortable-handler, Symbol icon-menu), aber „Drag Handle“ ist der Begriff, der in der Joomla-Community-Dokumentation und in Foren verwendet wird, und ist der für Leser leichter erkennbare Begriff.
Beispiel: „Auf den Drag Handle neben Seitenleisten-Ankündigung klicken und ihn an den Anfang der Liste ziehen.“