Best Practices
+
+- Platziere Fehlermeldungen in unmittelbarer Nähe zur Ursache des Problems.
+- Stelle sicher, dass Fehlermeldungen kurz, verständlich, hilfreich und
+handlungsorientiert sind.
+- Versuche bei jeder Fehlermeldung eine Lösung zu kommunizieren.
+- Unterscheide verschiedene Arten von Fehlermeldungen, basierend auf ihrem
+Umfang und ihrer Dringlichkeit.
+
+
+
Grundlagen
+
Kurz und hilfreich
+
Fehlermeldungen sollten kurz, sinnvoll und hilfreich für den Nutzer sein. Es
+gilt: So kurz wie möglich, aber so lang wie nötig. Das bedeutet allerdings auch,
+dass es in manchen Fällen ausreichend sein kann, nur die Lösung zu nennen.
+
Wir unterstützen die Formatierung nicht. Bitte gib eine E-Mail-Adresse im Format
+name@domain.de ein.
Don't
Bitte gib eine E-Mail-Adresse im Format name@domain.de ein.
Do
+
Verständliche Sprache, keine Fachsprache
+
Vermeide technische Begriffe und konzentriere dich auf eine einfach
+verständliche Sprache. Nutzer verstehen so am ehesten, was schief gelaufen ist
+und wie sie das Problem lösen können.
+
Fehlercode 503: Verbindung zum Server fehlgeschlagen.
Don't
Wir konnten keine Verbindung zum Server herstellen. Bitte versuche es erneut.
Do
+
Schuldzuweisungen vermeiden
+
Ein Fehler an sich ist bereits unangenehm und frustrierend. Daher sollte die
+Fehlermeldung dem Nutzer das Gefühl von Unterstützung und Fürsorge vermitteln,
+anstatt ihm ein Schuldgefühl zu vermitteln oder seine Frustration zu verstärken.
+
Du hast ein ungültiges Bild hochgeladen. Überprüfe die Dateigröße und versuche
+es erneut.
Don't
Wir konnten das Bild nicht hochladen. Bitte überprüfe die Dateigröße und
+versuche es erneut.
Do
+
Fehler eingestehen, Verständnis erleichtern
+
Fehlermeldungen sind einfacher zu verstehen, wenn sie sich auf das System als
+"wir" und den Nutzer als "du" beziehen. So werden die Fragen "Wo ist etwas
+schiefgegangen?" und "Wer muss handeln, um es zu beheben?" einfach und
+verständlich beantwortet.
+
Fehler beim Zurücksetzen des Passworts. Bitte versuche es erneut.
Don't
Wir konnten dein Passwort nicht zurücksetzen. Bitte überprüfe die E-Mail-Adresse
+und versuche es erneut.
Do
+
Keine ungerechtfertigten Entschuldigungen
+
Entschuldige dich nicht für kleine Fehler. Dies kann Fehler oft schlimmer
+erscheinen lassen und vom wichtigen Teil der Nachricht ablenken.
+Entschuldigungen sollten für ernsthafte Fehler aufgespart werden, wie den
+Verlust von Daten oder wenn der Nutzer eine größere Aktion zur Behebung des
+Problems ausführen muss.
+
Es tut uns leid, wir unterstützen das Dateiformat nicht.
Don't
Entschuldige dicht nicht für Kleinigkeiten oder wenn das System keine Schuld
+trägt.
Wir konnten die Datei nicht hochladen. Bitte verwende eine Datei vom Typ XY.
Do
Entschuldige Dich bei ernsthaften Fehlern, z.B. einem systembedingten Verlust von Daten.
+
Wahrscheinlichsten Fehler nennen
+
Wenn ein Fehler genau eine Ursache hat, dann erkläre, wie der Fehler zu beheben
+ist. Gibt es mehrere mögliche Gründe, so sollte die Fehlermeldung beschreiben,
+wie der wahrscheinlichste Grund zu beheben ist.
+
Das eingegebene Passwort entspricht nicht den Mindestanforderungen. Stelle
+sicher, dass es min. 8 Zeichen, einen Groß- und Kleinbuchstaben, eine Ziffer und
+ein Sonderzeichen enthält.
Don't
Dein Passwort muss mindestens 8 Zeichen enthalten.
Do
+
Nicht zu spezifisch
+
Formuliere Fehlermeldungen lieber etwas allgemeiner als zu spezifisch. Oft ist
+es nicht erforderlich, spezifische Details wie Dateinamen, Benutzernamen oder
+Ordner zu nennen, da der Nutzer diese Informationen an anderen Stellen in der
+Benutzeroberfläche finden kann.
+
Wir konnten die Datei „example_file-20.4.24.xy“ nicht hochladen. Bitte verwende
+eine Datei vom Typ XY.
Don't
Wir konnten die Datei nicht hochladen. Bitte verwende eine Datei vom Typ XY.
Do
+
Aktiv schreiben
+
Fehlermeldungen werden aktiv formuliert, um das Verständnis zu erleichtern.
+
Es werden nur Dateien vom Typ XY unterstützt.
Don't
Wir unterstützen nur Dateien vom Typ XY.
Do
+
Positiv formulieren
+
Versuche, Fehlermeldungen positiv zu formulieren und auf negativ besetzte
+Begriffe (z.B. Fehler, Problem, fehlgeschlagen, falsch, ungültig, verboten, ...)
+zu verzichten. Konzentriere dich stattdessen auf die Lösung und was als nächstes
+getan werden kann. Beachte jedoch, dass dies in Fällen von Systemfehlern, für
+die es keine direkte Lösung gibt, nicht immer möglich ist.
+
Durch ein Problem mit dem Server ist die Verbindung fehlgeschlagen.
Don't
Es tut uns leid, wir konnten keine Verbindung zum Server herstellen. Bitte
+versuche es erneut.
Do