Warnbox: Wann und wie man sie einsetzt
Nutzen Sie Warnboxen, um ein konkretes Risiko zu benennen, dessen Konsequenz zu erklären und die sichere Handlung anzugeben – vor irreversiblen, kostspieligen, regulierten oder gefährlichen Arbeiten.
Eine Warnbox stoppt den Leser vor einer Handlung, die einen materiellen Schaden verursachen könnte. Sie ist kein allgemeiner Hervorhebungsstil. Eine veröffentlichungsreife Warnung nennt das Risiko, die Konsequenz und die Handlung, die den Schaden vermeidet oder begrenzt.
Das Live-Element funktioniert, weil es benennt, was schiefgehen kann, erklärt, was verloren geht, und eine sichere Abfolge vor der destruktiven Steuerung vorgibt. „Seien Sie vorsichtig beim Löschen“ wäre nicht ausreichend: Es überträgt die Risikobewertung zurück an den Leser, ohne ihm zu sagen, was vorsichtiges Verhalten bedeutet.
Warum dieses Element wichtig ist
Warnungen existieren, um eine Entscheidung zu ändern, bevor ein Schaden eintritt. Ein Leser, der Anweisungen folgt, konzentriert sich meist darauf, das versprochene Ergebnis zu erreichen, und überfliegt daher Einschränkungen, die wie gewöhnlicher Hintergrundtext wirken. Eine klar abgegrenzte Warnung unterbricht diesen Schwung an dem Punkt, an dem der Leser noch eine Wahl hat. Sie schafft eine bewusste Pause, erklärt, warum die Pause wichtig ist, und bietet eine sichere nächste Handlung an.
Dieses Element dient der Psychologie des Lesers nur, solange Autoren es selektiv einsetzen. Wenn alltägliche Ratschläge, geringfügige Unannehmlichkeiten und irreversible Verluste alle gleich behandelt werden, lernen Leser, dass das visuelle Signal selten wichtig ist. Sie beginnen, es zu überspringen. Übertreibung erzeugt daher genau die Fehlerart, die eine Warnung verhindern soll: Die wichtige Botschaft wird ignoriert, wenn es wirklich ernst wird. Der Ton muss informieren, nicht verängstigen.
Maschinelle Extraktion bedeutet, dass Software die Warnung isolieren und ihre Bedeutung außerhalb der umgebenden Absätze bewahren kann. Ein typisierter Block mit einer textuellen Warnkennzeichnung und einem in sich geschlossenen Textkörper ist leichter zu identifizieren als ein roter Satz, der in einem Schritt versteckt ist. Die Risiko-Konsequenz-Handlung-Struktur übersteht auch Präsentationsänderungen. Ein automatisiertes Publikationssystem kann den Inhalt zwischen Markdown, Hugo und WordPress verschieben, ohne ableiten zu müssen, welcher Satz den Schaden beschreibt oder was der Leser tun soll.
Befolgen Sie die Schreibregeln für Elemente bei der Zuordnung des Elements. Farbe, ein Symbol, fetter Text oder eine mit „Wichtig“ betitelte Überschrift erzeugen für sich genommen keine Warnsemantik. Die Wörter müssen vollständig bleiben, wenn sie als Klartext kopiert oder ohne visuelle Gestaltung der Seite gelesen werden.
Wann man es verwendet
Verwenden Sie eine Warnung, wenn der Leser kurz davor steht, eine Wahl zu treffen oder eine Handlung mit einer vorhersehbaren materiellen Konsequenz auszuführen. Das Element ist zwingend erforderlich, wenn der Inhalt einen dieser Auslöser abdeckt:
- Irreversible Handlung: Löschen, Überschreiben, Veröffentlichen, Absenden, Kontoschließung oder eine andere Handlung, die nicht zuverlässig rückgängig gemacht werden kann.
- Datenverlust oder -offenlegung: Datensätze können gelöscht, beschädigt, offengelegt, übertragen oder unzugänglich gemacht werden.
- Kostenauswirkung: Eine Handlung löst eine Gebühr aus, verlängert eine Verpflichtung, verbraucht ein kostenpflichtiges Kontingent oder verursacht Kosten, die am Entscheidungspunkt nicht offensichtlich sind.
- Sicherheits- oder Gesundheitsrisiko: Das Befolgen, Kombinieren oder Auslassen einer Anweisung könnte zu Verletzungen, Krankheit oder verzögerter Behandlung führen.
- Rechtliche oder Compliance-Risiken: Eine Handlung könnte gegen ein Gesetz, einen Vertrag, eine Richtlinie, eine Lizenz, eine Aufbewahrungsregel, eine Einwilligungsanforderung oder ein reguliertes Genehmigungsverfahren verstoßen.
Der Auslöser – nicht die Vorliebe des Autors oder der verfügbare Wortumfang – bestimmt die Aufnahme. Wenn einer zutrifft, darf die Warnung nicht zu einer vagen Bezeichnung verkürzt, in einen allgemeinen Haftungsausschluss verschoben oder weggelassen werden, um in eine Vorlage zu passen. Kürzen Sie zuerst die umgebenden Erläuterungen.
Verwenden Sie keine Warnung für eine nützliche Abkürzung, eine bewährte Praxis, eine Definition, eine geringfügige Unannehmlichkeit, eine normale Voraussetzung oder einen umkehrbaren Fehler mit einer offensichtlichen Behebung. Dies sind Grenzfälle, weil sie in der Alltagssprache vielleicht „wichtig“ sind, aber keine Stopp-Entscheidung erfordern. Setzen Sie erforderliche Voraussetzungen in den Ablauf, optionale Verbesserungen in eine Tippbox und die übliche Fehlerbehebung neben den Schritt, den sie repariert.
Warnen Sie nicht nur, weil ein Ergebnis unerwünscht ist. „Titel von geringer Qualität können die Klickrate senken“ ist eine Erklärung der Leistung, keine Warnung. Es wird erst dann zu Warnmaterial, wenn eine nahegelegene Handlung eine spezifische, materielle Konsequenz schafft: Zum Beispiel, wenn die Änderung der URL-Struktur einer Live-Seite ohne Weiterleitungen eingehende Links brechen und indizierte Ziele entfernen kann. Geben Sie in diesem Fall die vorbeugende Handlung vor der Änderung an.
Wo man es platziert
Eine Warnung gehört unmittelbar vor die erste Handlung, die sie betrifft. „Handlung“ umfasst eine nummerierte Anweisung, einen Befehl, das Absenden eines Formulars, eine Kaufsteuerung, einen Download, eine Empfehlung oder eine Entscheidung, die ein Leser umsetzen könnte. Setzen Sie die Box nach ausreichend Kontext, um die Situation zu identifizieren, aber vor der ersten ausführbaren Anweisung. Nennen Sie das Risiko niemals erst nach der Handlung, in Endnoten oder nur in einem abschließenden FAQ.
Wenn eine Warnung eine Abfolge regelt, platzieren Sie sie vor der Abfolge und benennen Sie ihren Geltungsbereich: „Die nächsten drei Schritte ersetzen die Produktionsdatenbank.“ Wiederholen Sie dieselbe Warnung nicht in jedem Schritt. Wenn ein späterer Schritt ein anderes Risiko einführt, fügen Sie eine zweite Warnung unmittelbar vor diesem Schritt hinzu.
Eine Warnung darf nicht direkt neben einem anderen Hinweis, einem werblichen Call-to-Action oder einem dekorativen Banner stehen. Benachbarte Boxen konkurrieren um Aufmerksamkeit und können die Warnung wie Teil eines Marketing-Stapels aussehen lassen. Sie darf keine Anweisung von ihrer erforderlichen Eingabe, keine Behauptung von ihrem Beleg und keinen Tabellentitel von der Tabelle trennen. Fügen Sie einen einfachen Übergang hinzu oder strukturieren Sie den Abschnitt um, sodass die Warnung eindeutig eine Entscheidung qualifiziert.
Platzieren Sie rechtliche Standardtexte gemäß der geltenden Richtlinie, aber belassen Sie die operative Warnung neben der riskanten Handlung. Die Warnung in eine Fußzeile zu verschieben, nur weil bereits ein Haftungsausschluss existiert, macht ihren Zweck zunichte.
Anatomie
Das gerenderte Element hat sechs semantische Bereiche:
- Schweregradkennzeichnung: sichtbarer Text, der sagt, dass dies eine Warnung ist; sie darf nicht nur durch Farbe oder ein Symbol vermittelt werden.
- Spezifischer Titel: benennt die Entscheidung oder Gefahr, z. B. „Warnung: Datensätze vor dem Löschen exportieren.“
- Risiko: gibt an, welche Handlung oder Bedingung schiefgehen kann.
- Konsequenz: nennt das glaubwürdige Ergebnis und wer oder was betroffen ist.
- Handlung: sagt dem Leser, wie er das Risiko vermeiden, reduzieren, überprüfen oder eskalieren kann, bevor er fortfährt.
- Positionsbeziehung: verbindet die Warnung mit der nächsten Handlung, die sie regelt.
Die Legende bleibt als Live-Text auf der Seite bestehen, anstatt in das Bild eingebettet zu werden. Dadurch bleibt jedes Label für assistive Technologien verfügbar und das Design kann geändert werden, ohne die Spezifikation ungenau zu machen.
Designbeispiele
Die aktuelle Bibliothek unterstützt einen Warnschweregrad: Hugo rendert ihn mit type="important". Es gibt keine separate Variante für Vorsicht, Warnung, Gefahr, kritisch oder Notfall. Diese bewusste Einfachheit sorgt für konsistente Autorenentscheidungen und verringert die Wahrscheinlichkeit, dass zwei Autoren derselben Konsequenz unterschiedliche Farben zuweisen. Der Nachteil ist, dass die Komponente einen finanziellen Verlust, der behoben werden kann, visuell nicht von unmittelbarer körperlicher Gefahr unterscheiden kann. Autoren müssen den Schweregrad im Titel und in der Konsequenz angeben, anstatt sich auf eine stärkere Farbe zu verlassen.
Die Galerie testet daher den einen Schweregrad unter seinen unterstützten Inhaltsvarianten: das Standardlabel, einen spezifischen benutzerdefinierten Titel, maximal zwei Absätze und einen schmalen Viewport. Dies sind Rendering-Fälle, keine unterschiedlichen Schweregrade.
Erfinden Sie keinen Schweregrad durch Emojis, Großschreibung, wiederholte Ausrufezeichen, benutzerdefinierte Klassen oder nicht unterstützte Typwerte. Sollte die Bibliothek später mehrere Stufen erhalten, müssen deren Grenzen auf Konsequenz und erforderlicher Reaktion basieren, nicht darauf, wie stark der Autor die Passage empfindet.
Parameter
Der Renderer hat nur type, title und Body als Eingaben. Risiko, Konsequenz und Handlung sind redaktionelle Felder innerhalb des Bodys; ihre explizite Nennung in diesem Vertrag verhindert, dass ein visuell gültiger Hinweis eine unvollständige Anleitung veröffentlicht.
| Name | Typ | Erforderlich | Min./Max. | Standard | Quelle |
|---|---|---|---|---|---|
type | Enum | Ja | Genau important | Keiner für dieses Element | Shortcode-Attribut |
title | Klartext | Ja | 3–9 Wörter; 70 Zeichen | Renderer-Standard ist Important, aber der Warnvertrag erfordert einen spezifischen Titel | Shortcode-Attribut |
risk | Einfaches Markdown | Ja | 1 Satz; 8–30 Wörter | Keiner | Body, erster Satz oder Satzteil |
consequence | Einfaches Markdown | Ja | 1 Satz; 8–35 Wörter | Keiner | Body nach dem Risiko |
action | Einfaches Markdown | Ja | 1–2 Sätze; 8–40 Wörter | Keiner | Body nach der Konsequenz |
body | Markdown | Ja | 25–90 Wörter; 1–2 Absätze | Keiner | Shortcode-Body |
inlineLink | URL plus Anker | Nein | 0–1 Link | Weggelassen | Body |
position | Dokumentbeziehung | Ja | Eine Handlung oder eine benannte Abfolge | Unmittelbar vor der geregelten Handlung | Elementplatzierung |
Der Titel sollte mit „Warnung:“ beginnen, sofern kein reguliertes Vokabular ein anderes explizites Schweregradwort vorschreibt. Der Body kann Risiko und Konsequenz in einem Satz kombinieren, aber alle drei Aufgaben müssen identifizierbar bleiben. Ein Link kann auf detaillierte Richtlinien oder Wiederherstellungsanweisungen verweisen; er darf die unmittelbare sichere Handlung nicht ersetzen.
Syntax und Codebeispiele
Alle drei Zuordnungen verwenden denselben Typ, Titel und Body. Die portable Direktive ist die kanonische Autorenform. Hugo verwendet den vorhandenen callout-Shortcode. WordPress kann denselben Vertrag als registrierten Block umsetzen; eine Shortcode-Form ist nur dort akzeptabel, wo diese Installation sie registriert hat.
Portable Markdown-Direktive
:::warning{title="Warnung: Datensätze vor dem Löschen exportieren"}
Das Löschen des Arbeitsbereichs entfernt dauerhaft dessen gespeicherte Berichte. Exportieren Sie die Datensätze, die Sie behalten müssen, und überprüfen Sie den Arbeitsbereichsnamen, bevor Sie das Löschen bestätigen.
:::
Hugo-Shortcode
{{< callout type="important" title="Warnung: Datensätze vor dem Löschen exportieren" >}}Das Löschen des Arbeitsbereichs entfernt dauerhaft dessen gespeicherte Berichte. Exportieren Sie die Datensätze, die Sie behalten müssen, und überprüfen Sie den Arbeitsbereichsnamen, bevor Sie das Löschen bestätigen.{{< /callout >}}
Verwenden Sie benannte Parameter zusammen. Mischen Sie nicht den positionellen Wert important mit einem benannten title-Parameter.
WordPress-Block oder -Shortcode
<!-- wp:amicited/warning {"title":"Warnung: Datensätze vor dem Löschen exportieren"} -->
<p>Das Löschen des Arbeitsbereichs entfernt dauerhaft dessen gespeicherte Berichte. Exportieren Sie die Datensätze, die Sie behalten müssen, und überprüfen Sie den Arbeitsbereichsnamen, bevor Sie das Löschen bestätigen.</p>
<!-- /wp:amicited/warning -->
[warning title="Warnung: Datensätze vor dem Löschen exportieren"]Das Löschen des Arbeitsbereichs entfernt dauerhaft dessen gespeicherte Berichte. Exportieren Sie die Datensätze, die Sie behalten müssen, und überprüfen Sie den Arbeitsbereichsnamen, bevor Sie das Löschen bestätigen.[/warning]
Die Darstellung kann systemübergreifend variieren, aber der textuelle Schweregrad, das Risiko, die Konsequenz, die Handlung und die Position vor der Handlung müssen die Konvertierung überstehen.
Beispiele
Gut: Kostenpflichtige Wiederaufbereitung mit Überschreibungsrisiko
Dieses Beispiel nennt zwei konkrete Risiken, gibt beide Konsequenzen an und liefert Handlungen, die sie verhindern. Sein Ton ist sachlich: Es behauptet nicht, das Konto sei ruiniert oder die Daten seien nicht wiederherstellbar, wenn ein aufbewahrter Export einen Wiederherstellungsweg bietet.
Schlecht: Risiko ohne Orientierung
Das schlechte Beispiel identifiziert die Operation nicht, beschreibt die glaubwürdige Konsequenz nicht und sagt dem Leser nicht, wie er sicher vorgehen kann. „Ernst“ ist eine nicht belegte Schweregradbehauptung, während „auf eigenes Risiko“ die Verantwortung verschiebt, anstatt das Verhalten zu lenken. Ersetzen Sie es durch die genaue Zustandsänderung, was verloren gehen oder verletzt werden kann, und die erforderliche Prüfung, Sicherung, Genehmigung, Alternative oder Abbruchbedingung vor der Handlung.
Ein weiteres Versagen ist übertriebener Alarmismus: „Fassen Sie diese Einstellung niemals an, sonst könnte Ihre gesamte Seite zerstört werden!“ Selbst wenn die Einstellung wichtig ist, ist die Formulierung nicht durch ein wahrscheinliches Ergebnis eingegrenzt und gibt keinen sicheren Weg vor. Leser, die feststellen, dass die Behauptung übertrieben ist, werden spätere Warnungen ignorieren.
Rechtliche und regulierte Inhalte
Ein Haftungsausschluss und eine Warnung erfüllen unterschiedliche Aufgaben. Ein Haftungsausschluss definiert Umfang, Qualifikationen, Unsicherheit, beruflichen Status oder die Grenzen der Verantwortung. Eine Warnung identifiziert eine vorhersehbare Gefahr an einem Entscheidungspunkt und ändert, was der Leser als Nächstes tun sollte. Eines kann das andere nicht ersetzen.
Halten Sie bei rechtlichen, finanziellen, gesundheitlichen, sicherheitsrelevanten, datenschutzbezogenen oder anderen regulierten Materialien den genehmigten Haftungsausschluss an seiner erforderlichen Seitenposition und fügen Sie eine Warnung vor jeder spezifischen Handlung hinzu, die ein Risiko schaffen könnte. Zum Beispiel hebt eine allgemeine Aussage, dass ein Artikel rein bildend ist, nicht die Notwendigkeit auf, zu warnen, bevor der Leser angewiesen wird, eine verschriebene Behandlung abzusetzen, regulierte Daten zu übertragen, eine Behauptung ohne Genehmigung zu veröffentlichen oder eine wiederkehrende Gebühr zu akzeptieren.
Autoren dürfen keine rechtlichen Schlussfolgerungen innerhalb der Warnung improvisieren. Verwenden Sie eine vom zuständigen Fach- oder Compliance-Prüfer genehmigte Formulierung, bewahren Sie jede erforderliche Terminologie und geben Sie die operative Handlung an, die der Leser tatsächlich durchführen kann: pausieren, Zustimmung einholen, Aufzeichnungen aufbewahren, einen qualifizierten Fachmann konsultieren, einen genehmigten Kanal nutzen oder zur Überprüfung eskalieren. Ein vager Link „konsultieren Sie die Bedingungen“ ist unzureichend, wenn die Seite die unmittelbare Stopp-Bedingung angeben kann.
Schema-Markup und Barrierefreiheit
Eine Warnbox hat keine eigene Schema-Markup
-Eigenschaft und sollte kein eigenständiges JSON-LD
-Objekt erzeugen. Sie bleibt sichtbarer Inhalt innerhalb des umschließenden Artikels. Wenn sie einen strukturierten Ablauf qualifiziert, kann ihr vollständiger Text in die sichtbare Anweisung des entsprechenden Schritts und in den zugehörigen HowToStep.text aufgenommen werden; sie darf kein unechter Schritt werden oder nur in strukturierten Daten existieren.
Accessible Rich Internet Applications (ARIA)-Rollen kommunizieren Schnittstellenverhalten an assistive Technologien, wenn natives HTML dies nicht bietet. Statische Warnungen, die beim Laden der Seite vorhanden sind, sollten in der normalen Dokumentenreihenfolge bleiben und benötigen kein role="alert". Eine Alert-Rolle verursacht eine sofortige Ansage und ist nur angemessen, wenn eine dringende Warnung dynamisch nach einer Interaktion erscheint. Die Anwendung auf jeden statischen Hinweis kann Screenreader-Nutzer unterbrechen und den routinemäßigen Seitenaufruf laut machen. Der aktuelle Hugo-Renderer gibt ein beschriftetes <div> ohne ARIA-Rolle aus, was für einen statischen Block akzeptabel ist, wenn sein Text und seine Platzierung die Bedeutung vermitteln.
Farbunabhängigkeit bedeutet, dass die Warnung in Schwarzweiß, im Hochkontrastmodus, in einer reinen Textexportierung und in der Screenreader-Ausgabe erkennbar bleibt. Verwenden Sie einen expliziten „Warnung:“-Titel und beschreiben Sie den Schweregrad in Worten: „löscht dauerhaft“, „startet eine wiederkehrende Gebühr“, „kann personenbezogene Daten offenlegen“ oder „erfordert ärztliche Behandlung“. Schreiben Sie nicht „vermeiden Sie die rote Option“ und verlassen Sie sich nicht auf den Alternativtext eines Symbols, um die Gefahr zu vermitteln.
Halten Sie Titel und Body in Lesereihenfolge vor der geregelten Handlung. Links benötigen beschreibenden Ankertext, der Tastaturzugriff darf nicht vom Hinweis abhängen, und wesentliche Anweisungen dürfen nicht nur in einem Screenshot erscheinen. Wenn eine zukünftige interaktive Komponente das Schließen erlaubt, darf das Schließen eine obligatorische Warnung nicht verbergen, solange die Handlung verfügbar bleibt.
Schreibregeln
Schreiben Sie eine spezifische Warnung in 25–90 Wörtern und nicht mehr als zwei kurzen Absätzen. Verwenden Sie einen Titel mit 3–9 Wörtern, der normalerweise mit „Warnung:“ beginnt. Nennen Sie die auslösende Handlung oder Bedingung, die glaubwürdige Konsequenz und die sichere Reaktion. Setzen Sie den Grund vor die Regel: Leser befolgen Anweisungen zuverlässiger, wenn sie verstehen, was die Regel verhindert.
Verwenden Sie proportionale Verben. „Löscht dauerhaft“, „überschreibt“, „berechnet Gebühren“, „legt offen“, „macht ungültig“ und „kann verursachen“ beschreiben Mechanismen oder Ergebnisse. „Verwüstet“, „katastrophal“, „angsteinflößend“ und „folgenschwer“ dramatisieren meist, anstatt zu präzisieren. Geben Sie Unsicherheit ehrlich an, wenn das Ergebnis vom Kontext abhängt, und garantieren Sie niemals Sicherheit, nur weil der Leser eine Vorsichtsmaßnahme befolgt.
Halten Sie einen Entscheidungspunkt pro Box. Eine kurze Liste ist nur akzeptabel, wenn mehrere Prüfungen alle vor dieser einen Handlung stattfinden müssen; andernfalls verwenden Sie Prosa. Setzen Sie keine Werbetexte, Vorteile, Erfahrungsberichte, Witze, dekorative Emojis, nicht zusammenhängende Tipps, eine vollständige Anleitung, eine Vergleichstabelle, mehrere Überschriften oder einen Call-to-Action in die Warnung. Verstecken Sie keine erforderlichen Anweisungen hinter einem Link.
Verwenden Sie die Box niemals, um eine nicht belegte Behauptung zu schützen, einen Leser zum Kauf zu drängen oder künstliche Dringlichkeit zu erzeugen. Wenn die Handlung erforderlich ist, belassen Sie die Handlung im Hauptablauf und geben Sie den vorbeugenden Schritt in der Warnung an. Die Box lenkt die Aufmerksamkeit; sie ersetzt nicht die operative Struktur des Dokuments.
Beitragstypen, die es verwenden
Das postTypes-Frontmatter erfasst die registrierten Formate, in denen Warnauslöser vorhersehbar sind. In jeder Zeile bedeutet „zwingend“, dass der Autor kein Ermessen hat, sobald der genannte Auslöser erscheint; das Element darf nicht entfernt oder unter Risiko, Konsequenz und Handlung komprimiert werden, um ein Längenziel zu erreichen.
| Beitragstyp | Zwingender Auslöser | Erforderliche Position |
|---|---|---|
| Ultimate Guide | Der Guide enthält Anweisungen zu Sicherheit, Gesundheit, Recht, Compliance, Kosten, destruktiven Handlungen oder Datenverarbeitung. | Vor der ersten riskanten Anweisung in jedem eigenständig handelbaren Abschnitt. |
| How-to-Guide | Ein Schritt ist irreversibel, kann Daten verlieren oder offenlegen, verursacht Kosten, schafft ein reguliertes Risiko oder birgt ein Sicherheits- oder Gesundheitsrisiko. | Nach den relevanten Voraussetzungen und unmittelbar vor dem betroffenen Schritt oder der Abfolge. |
| Was-ist-Seite | Die Erklärung enthält Ratschläge, die ein Leser in einem regulierten, medizinischen, sicherheitssensiblen oder rechtlich folgenreichen Kontext umsetzen könnte. | Vor der ersten umsetzbaren Empfehlung, nicht innerhalb der Definition. |
| Produktseite | Eine Steuerung, ein Kauf, eine Kündigung, eine Migration, eine Löschung, eine Integration oder eine Datennutzung hat eine materielle Kosten- oder irreversible Konsequenz, die nicht offensichtlich ist. | Neben und vor der relevanten Handlung oder Entscheidung; niemals nur in den Fußzeilenbedingungen. |
| Kategorieseite | Auswahlhinweise könnten eine Kompatibilitäts-, Gesamtkosten-, Sicherheits-, Gesundheits-, Rechts- oder Compliance-Konsequenz erzeugen. | Vor der Empfehlung oder Filterauswahl, die den Leser dem Risiko aussetzt. |
| Anwendungsfall-Seite | Der beworbene Workflow verarbeitet regulierte Daten, automatisiert eine folgenreiche Entscheidung, verursacht Kosten oder kann irreversible oder unsichere Ergebnisse hervorbringen. | Vor der Workflow-Stufe oder Produkthandlung, die das Risiko einführt. |
Andere Beitragstypen können eine Warnung verwenden, wenn dieselben Auslöser auftreten. Die Tabelle definiert wiederkehrende, nicht optionale Fälle; sie gewährt keine Ausnahme für Formate, die in postTypes nicht aufgeführt sind.
QA-Checkliste
Überprüfen Sie vor der Veröffentlichung alle folgenden Punkte:
- Die Box nennt eine bestimmte Handlung, Bedingung oder Entscheidung, die das Risiko erzeugt.
- Die Konsequenz gibt ohne Übertreibung an, was passieren kann und wer oder was betroffen ist.
- Die Handlung sagt dem Leser, wie er das Risiko vermeiden, reduzieren, überprüfen, stoppen oder eskalieren kann.
- Die Warnung erscheint vor der ersten geregelten Handlung und benennt klar ihren Geltungsbereich.
- Kein Tipp, keine Werbung, kein Banner und keine zweite Warnung konkurrieren direkt mit ihr.
- Ein zwingender Auslöser wurde nicht aufgrund von Layout oder Wortanzahl weggelassen oder verkürzt.
- Der Typ
importantund der spezifische textuelle Warntitel sind vorhanden. - Der Schweregrad bleibt ohne Farbe, Symbole, Bilder oder umgebenden Kontext klar.
- Eine statische Warnung verwendet keine unnötige Alert-Rolle; eine dynamische dringende Warnung wird angemessen angekündigt.
- Ein etwaiger Haftungsausschluss bleibt getrennt und ersetzt keine unmittelbare Handlungsanleitung.
- Regulierte Formulierungen und erforderliche Terminologie haben die entsprechende fachliche Genehmigung.
- Markdown-, Hugo- und WordPress-Zuordnungen bewahren denselben Titel, denselben Body und dieselbe Position.
- Der Body bleibt innerhalb von 25–90 Wörtern, enthält keine Marketing-Sprache und verwendet nicht mehr als einen notwendigen Link.
- Screenshot-Kommentare nennen nur die erforderlichen zukünftigen Aufnahmen; kein nicht vorhandener Bildpfad wird gerendert.
FAQ
Was muss jede Warnbox enthalten? Das spezifische Risiko, seine glaubwürdige Konsequenz und die sichere Handlung müssen alle vorhanden sein. Das Element ist unvollständig, wenn einer dieser Teile fehlt.
Darf eine Warnbox nach der riskanten Handlung erscheinen? Nein. Sie muss erscheinen, bevor der Leser handeln kann, auch wenn dies eine Umstrukturierung der umgebenden Schritte erfordert.
Ersetzt ein rechtlicher Haftungsausschluss eine Warnbox? Nein. Der Haftungsausschluss definiert Umfang oder Einschränkungen; die Warnung ändert das Verhalten an einem bestimmten Entscheidungspunkt. Regulierte Seiten können beide erfordern.
Sollte eine Warnbox eine Alert-Rolle verwenden? Nicht, wenn sie bereits beim Laden der Seite vorhanden ist. Reservieren Sie die Alert-Rolle für dringende Informationen, die dynamisch nach einer Interaktion eingefügt werden.
Wie viele Warnboxen kann eine Seite enthalten? Verwenden Sie eine pro eindeutigem Entscheidungspunkt und fassen Sie Warnungen mit demselben Ziel zusammen. Wenn Warnungen die Seite dominieren, strukturieren Sie den Ablauf um oder überdenken Sie, ob die Handlung überhaupt angeboten werden sollte.
Eine Warnbox verdient ihre visuelle Hervorhebung nur, wenn sie einen konkreten Schaden verhindert. Nennen Sie ruhig das Risiko, die Konsequenz und die Handlung, platzieren Sie sie vor der Entscheidung und bewahren Sie diese Bedeutung in jeder Ausgabe.
Weitere Tutorials in diesem Bereich
Bereit, es in die Praxis umzusetzen?
Kostenlose Prüfung · 7 Tage testen · keine Kreditkarte