Windows Admin Center – UI-Text- und -Design-Styleguide
Gilt für: Windows Admin Center
Dieses Thema beschreibt den allgemeinen Ansatz zum Schreiben von Text für die Benutzeroberfläche (User Interface, UI) von Windows Admin Center sowie einige spezifische Konventionen und Ansätze, die wir verfolgen.
Windows Admin Center und alle Erweiterungen sollten den Sprachprinzipien von Microsoft folgen, um eine einfach zu bedienende und benutzerfreundliche Oberfläche zu gewährleisten. Dieser Styleguide baut auf den erwähnten Sprachprinzipien und auf dem Microsoft Writing Style Guide auf. Daher sollten Sie sich in diesen beiden Ressourcen über Themen wie Barrierefreiheit, Akronyme und Wortwahl wie Please und Sorry informieren.
Schaltflächen
Schaltflächen sollten nach Möglichkeit aus einem Wort bestehen, insbesondere wenn Sie Ihr Tool lokalisieren möchten. Zwei oder drei Wörter sind akzeptabel, allerdings sollten Sie mehr vermeiden. Ab vier Wörtern empfiehlt sich die Verwendung eines Steuerelements in Form eines Links.
Schaltflächenbeschriftungen sollten prägnant, spezifisch und selbsterklärend sein. Verwenden Sie anstelle einer generischen Schaltfläche wie „Absenden“ ein Verb, das der Benutzeraktion entspricht, z. B. „Erstellen“, „Löschen“, „Hinzufügen“, „Formatieren“ usw.
Wenn eine Schaltfläche auf eine Frage folgt, sollte ihre Beschriftung eindeutig der Frage entsprechen (in der Regel „Ja“ oder „Nein“).
Verwenden Sie beim Starten eines Erstellungsflows die geeignete Schaltflächenbeschriftung:
Schaltfläche Zweck Erstellen Erstellen einer neuen Ressource/eines neuen Objekts/usw. Add Hinzufügen einer vorhandenen Ressource/eines vorhandenen Objekts/usw. zum Tool Installieren Installieren von Software/Erweiterungen
Großbuchstaben
Wir richten uns bei der Groß-/Kleinschreibung nach dem Microsoft-Stil. Daher sollten Sie in den meisten Fällen die Groß-/Kleinschreibung verwenden, wie sie in Sätzen vorkommt.
| Benutzeroberflächenelement | Großbuchstaben | Kommentare |
|---|---|---|
| Badges (z. B. VORSCHAU) | Großbuchstaben | |
| Alle anderen | Satzformat | Es gibt jedoch einige Ausnahmen, bei denen Objekteigenschaften von WMI oder PowerShell angezeigt werden, die außerhalb unserer Kontrolle liegen. |
Doppelpunkte
Verwenden Sie Doppelpunkte, um Listen einzuführen. Zum Beispiel:
Wählen Sie eine der folgenden Optionen aus:
- Katzen
- Hunde
- Quokkas
Verwenden Sie keine Doppelpunkte im Benutzeroberflächentext, wenn sich eine Beschriftung in einer anderen Zeile als das Element befindet, das beschriftet werden soll, oder wenn es einen klaren Unterschied zwischen der Beschriftung und dem Element gibt, auf das sich die Beschriftung bezieht.
Verwenden Sie Doppelpunkte im Benutzeroberflächentext, wenn eine Beschriftung in derselben Zeile steht wie der Text, den sie beschriftet, und Sie verhindern müssen, dass die beiden Elemente zusammenlaufen.
Bestätigungsmeldungen
Bestätigungsdialoge sind nützlich, wenn das Fortfahren zu unerwarteten Ergebnissen wie Datenverlusten führen kann. Sie sollten überprüfbare, nützliche Informationen mit einem klaren Ergebnis enthalten, insbesondere bei Ereignissen, die nicht rückgängig gemacht werden können.
- Vergewissern Sie sich, dass eine Bestätigung erforderlich ist. Wenn keine neuen Informationen angeboten werden (z. B. bei „Sind Sie sicher?“), ist u. U. keine Bestätigungsmeldung erforderlich.
- Vergewissern Sie sich, dass der Kunde mit der Aktion fortfahren möchte.
- Achten Sie darauf, dass die Hauptanweisung (Überschrift) und der erläuternde Text (Hauptteil) nicht redundant sind.
- Definieren Sie in der Überschrift die möglichen Ergebnisse in Form einer Frage oder einer Aussage darüber, was als Nächstes geschieht. Beispiel: „Sollen alle Daten auf diesem Laufwerk gelöscht werden?“ oder „Sie sind dabei, alle Ihre Daten zu löschen“.
- Fügen Sie Details in den Hauptteil ein. Wenn es eine Variable gibt, z. B. den Namen des Elements, das Sie ändern wollen, fügen Sie die Variable hier ein.
- Fügen Sie eine einfache Frage ein (entweder in der Überschrift oder im Hauptteil), die eine klare Auswahl zwischen zwei Aktionsschaltflächen bietet.
- Für eine komplexe Auswahl sollten Sie Ja/Nein-Schaltflächen verwenden, die zum genauen Lesen anregen. Verwenden Sie für eine einfachere Auswahl Schaltflächen, die für die Aktion spezifisch sind, z. B. „Alle löschen“ oder „Abbrechen“.
Eindruck beim ersten Ausführen
Wenn ein Benutzer zum ersten Mal eine Seite besucht, können Sie ihn bei den ersten Schritten mit Ihrem Tool unterstützen. Sie haben folgende Möglichkeiten:
- Eine Textzeichenfolge auf einer leeren Seite, die kurze Anweisungen zu den ersten Schritten gibt, z. B.: Wählen Sie „Hinzufügen“ aus, um eine App hinzuzufügen.
- Ein Link zum Steuerelement, mit dem der Benutzer loslegen kann, z. B: Fügen Sie eine App hinzu, um zu starten.
- Eine kleine und kurze Animation oder ein Video, das dem Benutzer die ersten Schritte erläutert.
Hier einige Tipps aus unserem Windows-Styleguide:
1. Unterstützen Sie Ihre Benutzer
- Vermeiden Sie Marketingstil und -sprache.
- Wenn Sie etwas demonstrieren oder vorschlagen, stellen Sie sicher, dass das Endergebnis klar ist. Dem Kunden einfach nur zu zeigen, wie er einen Schritt ausführt, ist wenig hilfreich, wenn er nicht weiß, warum.
- Geben Sie Kunden keine Tipps, wenn sie nicht benötigt werden.
2. Visualisierungen sind hilfreicher als einfacher Text
Halten Sie Ihren Text so einfach wie möglich (beispielsweise durch kurze Animationen oder Videos).
3. Überfordern Sie Ihre Benutzer nicht
- Kombinieren Sie maximal 4 Popups und Tipps pro Benutzersitzung, einschließlich System- und Shellbenachrichtigungen.
- Stellen Sie sicher, dass Popups zur richtigen Zeit eingeblendet werden.
- Hindern Sie Kunden nicht daran, aktiv zu werden.
- Stellen Sie sicher, dass Popups auf einfache Weise ausgeblendet werden können.
4. Behalten Sie den Kontext im Blick
- Lehrreiche Inhalte sind am effektivsten, wenn sie zum richtigen Zeitpunkt angeboten werden.
- Tutorials oder Diashows sollten anschaulich sein.
- Keine leeren Marketingformulierungen: Konzentrieren Sie sich auf bestimmte Tipps und Tricks.
- Bieten Sie Ihren Kunden ggf. die Möglichkeit, später zum Tutorial zurückzukehren. (Häufig werden Informationen nicht beim ersten Mal erinnert, allerdings sind die Einrichtungsschritte möglicherweise nur einmal von Bedeutung).
- Leere Zustandsmeldungen bieten eine naheliegende Möglichkeit, um Benutzer zu informieren und/oder zu animieren, und sollten einfach und aussagekräftig sein.
5. Halten Sie die Einrichtung möglichst einfach
Wenn der Kunde einen weiteren Schritt ausführen muss, um den vollen Nutzen zu erzielen (Anmeldung bei einem Onlinedienst usw.), sollte dies so unkompliziert wie möglich sein.
- Meldungen sollten kurz und direkt sein.
- Und nicht schnell ausgeblendet werden. Sehen Sie eine Möglichkeit vor, sie von jeder beliebigen Stelle abzurufen.
- Ermöglichen Sie es Benutzern ggf., sie später anzuzeigen oder sich später daran erinnern zu lassen.
- Wenn Sie sie aus der Oberfläche entfernen, sollten Sie eine Möglichkeit bieten, schnell und einfach darauf zurückzugreifen.
Hilfelinks
Hier einige Tipps aus unserem Windows-Styleguide:
Wann sollte einen Hilfelink bereitgestellt werden?
Fast nie. Ein Hilfelink sollte nur in folgenden Fällen angeboten werden:
- Es gibt eine offensichtliche und wichtige Frage, die Kunden wahrscheinlich stellen, während sie mit der Benutzeroberfläche interagieren, und deren Beantwortung ihnen helfen wird, Aufgaben in der Benutzeroberfläche zu meistern.
- Die Benutzeroberfläche bietet nicht genug Platz, um die Menge an Informationen bereitzustellen, die Benutzer benötigen, um Aufgaben in der Benutzeroberfläche erfolgreich auszuführen.
Wo sollten Hilfelinks angezeigt werden?
- Textlinks sollten so nah wie möglich am UI-Element angezeigt werden, an das die Hilfe gerichtet ist.
- Wenn Sie einen Textlink angeben müssen, der für einen gesamten UI-Bildschirm gilt, platzieren Sie ihn unten links auf dem Bildschirm.
- Wenn Sie einen Link über eine Hilfeschaltfläche (?) bereitstellen, sollte die QuickInfo „Hilfe“ lauten.
Welche URL sollte verwendet werden?
Verweisen Sie niemals direkt auf eine Webadresse, sondern verwenden Sie einen Umleitungsdienst.
Microsoft-Entwickler sollten einen FWLink verwenden, es sei denn, es handelt sich um einen Hilfelink, den die Benutzer möglicherweise manuell eingeben müssen. In diesem Fall sollte ein aka.ms-Link verwendet werden (sofern das Ziel der URL eine Website ist, die das Browsergebietsschema automatisch erkennt, wie z. B. learn.microsoft.com).
Richtlinien für Text
- Verwenden Sie vollständige Sätze.
- Verwenden Sie keine abschließenden Satzzeichen außer Fragezeichen.
- Sie müssen nicht denselben Text wie die Beschriftung der Aufgabe verwenden. Verwenden Sie Text, der im Kontext der Benutzeroberfläche Sinn ergibt, aber stellen Sie sicher, dass eine logische Verbindung zwischen beiden besteht. Beispiel:
- Hilfelink: Welche Risiken bestehen beim Zulassen von Ausnahmen?
- Titel des Hilfethemas: „So können Sie zulassen, dass ein Programm durch die Windows-Firewall kommuniziert“
- Beschreiben Sie den Inhalt des Hilfethemas so genau wie möglich.
- Unser Stil
- Wie schützt die Windows-Firewall meinen Computer?
- Warum Glanzlichter ein Bild verbessern können
- Nicht unser Stil
- Weitere Informationen zur Windows-Firewall
- Weitere Informationen zur Farbverwaltung
- Weitere Informationen
- Unser Stil
- Verwenden Sie den gesamten Satz für den Linktext, nicht nur die Schlüsselwörter.
- Unser Stil
- Nicht unser Stil
- In einigen Fällen ist es in Ordnung, einen Link in der Form „Mehr erfahren“ zu verwenden, wenn der Kontext verdeutlicht, wohin der Benutzer gelangt, wenn er auf den Link klickt.
Fehlermeldungen
Hier einige Hinweise, die wir dem Windows-Styleguide entnommen haben:
Beim Verfassen einer guten Fehlermeldung kommt es darauf an, genügend Erklärungen zu liefern, aber nicht zu technisch zu sein; zwanglos und sympathisch zu sein, aber nicht nervig oder beleidigend.
Allgemeine Richtlinien
Verwenden Sie eine Meldung pro Fehler.
Überschriften
- Beschränken Sie sich auf das Wesentliche, und erklären Sie kurz und bündig, worin das Problem besteht oder was idealerweise zu tun ist.
Einige Benutzeroberflächen enthalten Überschriften, die abgeschnitten und nicht umbrochen werden, wenn sie zu lang sind. Daher sollten Sie darauf achten. - Verwenden Sie die Lösung in der Überschrift, wenn es sich um einen einfachen Schritt handelt.
- Stellen Sie sicher, dass sich die Überschrift direkt auf die Schaltfläche bezieht, falls der Leser den Haupttext ignoriert.
- Vermeiden Sie die Verwendung von „Es ist ein Problem aufgetreten“ in Überschriften, es sei denn, Sie haben keine andere Wahl. Gehen Sie genauer auf das Problem ein.
- Vermeiden Sie Variablen (z. B. Datei-, Ordner- und App-Namen) in Überschriften. Verwenden Sie diese im Hauptteil.
Text
Wenn die Überschrift das Problem oder die Lösung hinreichend erklärt, brauchen Sie keinen Fließtext.
Wiederholen Sie den Titel in der Meldung nicht mit leicht verändertem Wortlaut.
Kommunizieren Sie klar und deutlich, wie die Lösung aussieht.
Konzentrieren Sie sich zuerst auf die Fakten.
Machen Sie nicht die Benutzer für den Fehler verantwortlich.
Wenn dem Fehler ein Fehlercode zugeordnet ist und Sie der Meinung sind, dass die Angabe des Fehlercodes dem Kunden oder dem Microsoft-Support bei der Untersuchung des Problems helfen könnte, fügen Sie ihn direkt unter dem Haupttext ein, und schreiben Sie ihn wie folgt:
Fehlercode: ####
Wenn der Kunde über alle notwendigen Informationen verfügt, um den Fehler ohne den Code zu beheben, brauchen Sie ihn nicht anzugeben.
Schaltflächen
- Schreiben Sie den Schaltflächentext so, dass er eine spezifische Antwort auf die Hauptanweisung gibt. Wenn das nicht möglich ist, verwenden Sie „Schließen“ als Text für die Schaltfläche zum Beenden (anstelle von „OK“ oder „Fertig“).
- Wenn Sie über mehr als eine Schaltfläche verfügen, sollte die Schaltfläche ganz links die Aktion darstellen, zu der der Benutzer aufgefordert wird. Die Schaltfläche ganz rechts sollte die konservativere Aktion sein, z. B. „Abbrechen“.
Hilfelinks
Ziehen Sie Hilfelinks nur für Fehlermeldungen in Betracht, die nicht spezifisch und praktikabel sind.
Null-Zustand-Text
Hier finden Sie Unterstützung aus dem Windows-Styleguide.
Ein Null-Zustand liegt vor, wenn Kundendaten oder -inhalte in einer App oder Funktion fehlen, wenn nach einer Suche keine Ergebnisse zurückgegeben werden oder wenn erforderliche Informationen in einem Formular fehlen, z. B. Abrechnungsinformationen für eine Transaktion.
Richtlinien
- Nutzen Sie Null-Zustand-Situationen möglichst als Gelegenheit, Benutzer über die Nutzung von Funktionen zu informieren (z. B. wie Musik hinzugefügt wird, wo Bilder zu finden sind usw.).
- Wenn Ihre Benutzeroberfläche einen Titel enthält, erklären Sie, durch welche Aktion der Null-Zustand „behoben“ werden kann (z. B. „Musik hinzufügen“).
- Haben Sie ein wenig Spaß mit dem Text. Dieser Ort kann eine Gelegenheit sein, Freude zu bereiten, da er wahrscheinlich nicht mehrmals angezeigt wird.
- Vermeiden Sie: „Es ist sehr einsam hier.“ Das ist bedrückend und wurde überstrapaziert.
- Vermeiden Sie Fragen wie: „Haben Sie Ihren Drucker nicht angeschlossen?“ Die einmalige Verwendung ist in Ordnung, allerdings wird dieses Format oft überbeansprucht. Außerdem stellen die Fragen eine zusätzliche Belastung dar und setzen den Kunden unter Druck. Es kann sich auch herablassend anfühlen.
- Es ist eine gute Idee, Null-Zustand-Text zu variieren.
Beispiele
- „Fügen Sie jemanden als Favoriten hinzu, und Sie werden ihn hier sehen.“
- „Haben Sie Erfolge oder Spielclips, auf die Sie besonders stolz sind? Fügen Sie sie Ihrem Showcase hinzu.“
- „Noch feiert niemand eine Party. Starten Sie eine!“
- „Wenn Sie jemand als Freund hinzufügt, sehen Sie ihn hier.“
- „Wenn Sie Aktionen ausführen, wie Erfolge freischalten, Spielclips aufnehmen und Freunde hinzufügen, sehen Sie das alles hier.“
- „Ihre wichtigsten Freunde werden hier angezeigt, sodass Sie sehen können, wann sie online sind und was sie gerade machen.“
Interpunktion
- Verwenden Sie keine abschließenden Satzzeichen (Punkte, Fragezeichen) bei Überschriften oder unvollständigen Sätzen. Eine Ausnahme bildet ein Bestätigungsdialogfeld, in dem die Überschrift die Frage enthält.
- Orientieren Sie sich an den Hinweisen zu Punkten und Fragezeichen im Microsoft-Styleguide.
Statusmeldungen
Statusmeldungen bestehen aus Popupbenachrichtigungen und Benachrichtigungen.
| Zeichenfolgentyp | Hinweise |
|---|---|
| Popupbenachrichtigung | Groß- und Kleinschreibung mit abschließender Interpunktion – idealerweise mit einer Objektvariablen, damit Benutzer verstehen können, auf welches Objekt sich die Meldung bezieht, falls sie sich vom Objekt wegbewegt haben |
| Benachrichtigungsüberschrift (Titel) | Groß- und Kleinschreibung ohne abschließende Interpunktion (es handelt sich um eine Überschrift) – idealerweise mit einer Objektvariablen |
| Benachrichtigungsdetails | Vollständige Sätze, idealerweise mit einem Link zur Benutzeroberfläche, auf der das Objekt angezeigt wird |
Hier einige ausführliche Empfehlungen für Benachrichtigungen:
| Zeichenfolgentyp | Hinweise |
|---|---|
| Gestartet | Nach Möglichkeit auslassen. Normalerweise können Sie einfach zur „In Bearbeitung“-Meldung übergehen, um Ablenkungen zu minimieren. |
| In Bearbeitung | Beginnen Sie mit dem Verb der Aktion, die Sie ausführen, und enden Sie mit Auslassungspunkten, um auf einen laufenden Vorgang hinzudeuten. Hier sehen Sie ein Beispiel: Erstellen des Volumes „Kundendaten“... Wenn mehrere Variablen vorhanden sind, verwenden Sie dieses Muster: Löschen des folgenden virtuellen Computers: {0}; Host: {1} |
| Erfolg | Beginnen Sie mit der Erfolgsmeldung, und enden Sie mit der Aktion, die die Software gerade ausgeführt hat. Hier sehen Sie ein Beispiel: Das Volume „Kundendaten“ wurde erfolgreich erstellt. |
| Fehler | Verwenden Sie „konnte nicht“, und enden Sie mit der Aktion, die die Software nicht ausführen konnte. Hier sehen Sie ein Beispiel: Das Volume „Kundendaten“ konnte nicht erstellt werden. |
QuickInfos
Gute QuickInfos beschreiben kurz nicht beschriftete Steuerelemente oder bieten zusätzliche Informationen für beschriftete Steuerelemente, wenn dies sinnvoll ist. Sie können Kunden auch bei der Navigation auf der Benutzeroberfläche unterstützen, indem sie zusätzliche – nicht redundante – Informationen zu Steuerelementbeschriftungen, Symbolen, Links usw. bereitstellen.
QuickInfos sollten sparsam oder gar nicht verwendet werden. Sie können für den Kunden störend sein. Daher sollten Sie keine QuickInfos verwenden, die einfach nur eine Beschriftung wiederholen oder etwas Offensichtliches erklären. Sie sollten immer wertvolle Informationen beitragen.
| Kontext | So schreiben Sie QuickInfos |
|---|---|
| Wenn ein Steuerelement oder Benutzeroberflächenelement nicht beschriftet ist... | Verwenden Sie eine einfache, substantivierte Beschreibung. Zum Beispiel: Hervorheben des Stifts |
| Wenn ein Benutzeroberflächenelement beschriftet ist, sein Verwendungszweck jedoch geklärt werden muss... |
|
| Wenn eine Textbeschriftung in einigen Sprachen abgeschnitten ist oder abgeschnitten werden könnte... |
|
| Wenn eine Tastenkombination verfügbar ist... |
|