Checkliste: Schreibregeln, Platzierung und Beispiele

Eine Checkliste ist eine endliche Menge unabhängiger Aktionen oder Prüfschritte, die ein Leser als unerledigt oder erledigt markieren kann. Ihr prüfbarer Zustand ist Teil der Bedeutung: Das Erledigen jedes erforderlichen Elements sollte beweisen, dass eine bestimmte Aufgabe, Überprüfung oder Bereitschaftsbedingung abgeschlossen ist.

Dieses gerenderte Beispiel hat einen begrenzten Umfang, vier präzise Aktionen, sichtbare ungeprüfte Zustände und eine Erledigungsbedingung. Würde man dieselben Wörter in dekorative Aufzählungspunkte umwandeln, verlöre man das Versprechen, dass die Menge abschließbar ist.

Warum dieses Element wichtig ist

Leser nutzen eine Checkliste, um Gedächtnisarbeit auszulagern. Anstatt jedes Kriterium im Kopf zu behalten, während sie zwischen Entwurf, Browser, Design und Veröffentlichungsoberfläche wechseln, können sie eine Bedingung nach der anderen prüfen und Fortschritt festhalten. Die begrenzte Abgrenzung reduziert Unsicherheit: Der Leser weiß, was noch fehlt, was „erledigt" bedeutet und wann es sicher ist, fortzufahren.

Dieser psychologische Vertrag ist stärker als „hier sind ein paar nützliche Ideen." Ein Kontrollkästchen lädt zur Verbindlichkeit ein, während das letzte ungeprüfte Element bewusste Spannung erzeugt. Das Element muss daher ehrlich in seinem Umfang sein. Wenn die Liste ein erforderliches Prüfkriterium auslässt oder vage Wünsche wie „die Seite großartig machen" enthält, signalisiert die Oberfläche eine Sicherheit, die der Inhalt nicht verdient hat.

Maschinenextrahierbarkeit ist die Fähigkeit von Suchmaschinen, KI-Antwortsystemen, assistiven Technologien und Publikationswerkzeugen, jedes Element zu isolieren, ohne seine Rolle oder sein Erledigungsmodell zu verlieren. Eine typisierte Checkliste gibt eine benannte Sammlung, stabile Elementgrenzen, Anfangszustände und eine Erledigungsbedingung preis. Ein Parser kann erforderliche Prüfschritte von Beispielen oder Vorteilen unterscheiden, während ein KI-System eine in sich geschlossene Aktion mit dem Betreff der Checkliste zitieren kann.

Befolgen Sie die Element-Schreibregeln , bevor Sie die Komponente wählen. Deren Vorrangregel ist semantisch: Wenn der Zweck eines Blocks das Erledigen oder Überprüfen ist, verwenden Sie das Checklistenelement, selbst wenn gewöhnliche Aufzählungspunkte dieselben Wörter anzeigen könnten. Visuelle Ähnlichkeit bewahrt weder Zustand, Validierung, Barrierefreiheit noch Adapterzuordnung.

Wann man es verwendet

Verwenden Sie eine Checkliste, wenn die Menge endlich ist, jedes Element unabhängig bestehen oder durchfallen kann und das Erledigen der erforderlichen Elemente einen sinnvollen Zustand herstellt. Geeignete Themen umfassen die Vorab-Prüfung vor der Veröffentlichung, Beschaffungsanforderungen, Migrationsbereitschaft, Vorfallübergabe, Vollständigkeit von Dokumenten, Barrierefreiheitsprüfung und wiederkehrende Wartungsinspektionen.

Wenden Sie drei Tests an:

1. Zustandstest: Kann jedes Element eindeutig als unerledigt oder erledigt markiert werden?
2. Grenztest: Enthält die Liste alle erforderlichen Prüfungen für ihren erklärten Umfang?
3. Erledigungstest: Beweist das Erledigen der erforderlichen Elemente ein benanntes Ergebnis?

Wenn eine Antwort nein ist, ist wahrscheinlich ein anderes Element zutreffender. Die häufigsten Verwechslungen sind:

• Eine Aufzählungsliste gruppiert Fakten, Optionen, Beispiele oder Attribute. Ihre Elemente sind keine Aufgaben und die Menge wird nicht vollständig.
• Eine Schrittliste kodiert eine abhängige Reihenfolge. Wenn das Verschieben von Element 4 vor Element 2 zu Fehlern führen kann, sind Nummerierung und Wiederherstellungshinweise wichtiger als Kontrollkästchen.
• Eine Funktionsliste beschreibt, was ein Produkt hat. „Unterstützt CSV-Export" ist keine Prüfung, es sei denn, der Leser überprüft eine genannte Anforderung.
• Eine Wunschliste erfasst Präferenzen, deren Grenzen und Priorität sich ändern können. Sie sollte keine Erledigung versprechen.
• Eine Bewertungstabelle bewertet Dimensionen auf einer Skala. Binäre Prüfzustände würden nützliche Leistungsabstufungen verwerfen.
• Ein langer Ablauf mit einem Kontrollkästchen neben jedem Klick verwechselt Ausführung mit Überprüfung. Erklären Sie den Ablauf als Schritte und fügen Sie dann eine kurze Erledigungs-Checkliste hinzu.

Verwenden Sie keine Checkliste als Dekoration am Ende jedes Abschnitts. Wiederholte ungeprüfte Kästchen erzeugen Arbeit und suggerieren, der Leser sei nicht fertig, selbst wenn der Inhalt lediglich optionale Ratschläge bot.

Wo man es platziert

Die Platzierung folgt dem Moment, in dem der Leser handeln oder überprüfen kann. Stellen Sie zunächst die Aufgabe, den Umfang und den erforderlichen Kontext vor; platzieren Sie die Checkliste dann unmittelbar vor der Entscheidung, die sie steuert, oder unmittelbar nach dem Material, das sie zusammenfasst.

• Setzen Sie eine Bereitschafts-Checkliste nach den Voraussetzungen und vor einer unwiderruflichen oder kostspieligen Aktion.
• Setzen Sie eine Qualitätssicherungs-Checkliste nach dem Entwurf, der Konfiguration oder dem Verfahren, das sie bewertet, und vor der Freigabe oder Veröffentlichung.
• Setzen Sie eine Checkliste für Kaufanforderungen nach der Erläuterung von Bedürfnissen und Einschränkungen, aber vor der Eingrenzung von Produkten.
• Setzen Sie eine wiederkehrende Inspektions-Checkliste innerhalb des Wartungsabschnitts, neben ihrem Turnus und Verantwortlichen.
• Setzen Sie die Haupt-Checkliste in der Nähe des oberen Endes eines speziellen Checklisten-Artikels, nach einer kurzen Umfangsangabe, und erklären Sie dann schwierige Elemente darunter.

Eine Checkliste darf nicht direkt neben einer zweiten Checkliste mit überlappendem Umfang stehen; führen Sie sie zusammen oder geben Sie jeder eine eigene Überschrift und Erledigungsbedingung. Platzieren Sie sie nicht neben einer sequenziellen Schrittliste, ohne anzugeben, welcher Block der Ablauf und welcher die Überprüfung ist. Sie darf keine Warnung von der Konsequenz oder der erforderlichen Reaktion trennen, keine Vergleichstabelle unterbrechen oder in einem Call-to-Action sitzen. Setzen Sie niemals einen Werbeknopf zwischen das letzte Element und die Erledigungsbedingung.

Anatomie

Die beschrifteten Bereiche sind:

1. Umfangsüberschrift: benennt das genaue Objekt und die Entscheidung, z. B. „Link-Prüfung vor der Veröffentlichung."
2. Anweisung: sagt, was die Erledigung ermöglicht oder beweist.
3. Kontrollkästchen: zeigt den unerledigten oder erledigten Zustand programmatisch und visuell an.
4. Aktionsbezeichnung: beginnt mit einem konkreten Verb und bleibt für sich allein verständlich.
5. Optionaler Qualifikator: liefert einen Schwellenwert, Ort, Verantwortlichen oder Nachweisbedarf.
6. Pflichtfeldmarkierung: unterscheidet optionale Elemente nur, wenn der Vertrag sie tatsächlich erlaubt.
7. Fortschrittszusammenfassung: zeigt in interaktiven Varianten die erledigten und gesamten erforderlichen Elemente an.
8. Erledigungsbedingung: gibt das Ergebnis an, das erreicht ist, wenn alle erforderlichen Elemente bestanden sind.

Die Wörter bleiben maßgeblich. Ein Häkchensymbol, eine grüne Zeile oder eine durchgestrichene Bezeichnung kann den Zustand verstärken, aber nichts kann den nativen oder programmatischen aktivierten Zustand ersetzen.

Designbeispiele

Statische redaktionelle Checkliste

Verwenden Sie sichtbare ungeprüfte Steuerelemente für eine druckbare oder referenzierbare Checkliste. Der Leser darf sie kopieren oder ausdrucken, aber die Seite beansprucht nicht, Fortschritt zu speichern.

Interaktive Fortschritts-Checkliste

Verwenden Sie diese, wenn der Leser davon profitiert, Fortschritte während einer Sitzung zu markieren. Geben Sie die Anzahl bekannt, ohne den Fokus zu verschieben, und bieten Sie eine klare Zurücksetzungsaktion an.

Pflicht- und optionale Checkliste

Verwenden Sie diese nur, wenn optionale Aufgaben die Erledigungsbedingung tatsächlich nicht beeinflussen. Kennzeichnen Sie optionale Elemente im Text; verlassen Sie sich niemals allein auf hellere Farbe.

Gruppierte Checkliste

Bei mehr als zehn Prüfungen insgesamt unterteilen Sie die Arbeit in Gruppen von vier bis zehn mit eigenen Überschriften und Erledigungsbedingungen. Jede Gruppe ist unabhängig verständlich.

Druckzustand

Die Druckausgabe muss leere und erledigte Markierungen in Schwarzweiß beibehalten, Bezeichnungen neben ihren Steuerelementen belassen und vermeiden, eine kurze Gruppe über Seiten hinweg zu teilen.

Parameter

Der anfängliche checked-Wert ist für ausgearbeitete Beispiele, gespeicherte Vorlagen oder servereigene Aufgabenstatus gedacht. Redaktionelle Checklisten beginnen ungeprüft; Autoren dürfen ein Element niemals vorab aktivieren, nur um einen attraktiveren Screenshot zu erzeugen. Wenn interactive=false, muss persist den Wert none haben.

Syntax und Codebeispiele

Die kanonische Zuordnung folgt den Regeln für Vorrang, Textkörper und verschachtelte Elemente aus dem Basisvertrag. Das übergeordnete Element stellt das Sammlungsverhalten bereit; jedes Element liefert eine Bezeichnung, optionale Details und Zustandsfelder.

Portables Markdown-Direktiv

:::checklist{id="pre-publish-links" interactive=true persist=local}
## Pre-publish link check

Complete every required item before approving the page.

::item
### Open every internal link and confirm the destination exists
::

::item
### Confirm each anchor describes its destination out of context
::

::item{required=false}
### Check campaign parameters on optional promotional links
::

::item
### Verify keyboard focus is visible on every linked control
::

Complete when every required item passes and no exception remains.
:::

Hugo-Shortcode

{{< checklist id="pre-publish-links" title="Pre-publish link check" interactive="true" persist="local" completion="Complete when every required item passes and no exception remains." >}}
{{< checklist-item >}}Open every internal link and confirm the destination exists.{{< /checklist-item >}}
{{< checklist-item >}}Confirm each anchor describes its destination out of context.{{< /checklist-item >}}
{{< checklist-item required="false" >}}Check campaign parameters on optional promotional links.{{< /checklist-item >}}
{{< checklist-item >}}Verify keyboard focus is visible on every linked control.{{< /checklist-item >}}
{{< /checklist >}}

Dies ist die erforderliche Hugo-Adapterform, keine Behauptung, dass das Repository den Shortcode bereits bereitstellt. Bis ein registrierter Renderer existiert, verwenden Sie semantisches HTML für ein Live-Beispiel, anstatt die Komponente mit unzusammenhängenden Stilen nachzuahmen.

WordPress-Block

<!-- wp:amicited/checklist {"id":"pre-publish-links","title":"Pre-publish link check","interactive":true,"persist":"local","completion":"Complete when every required item passes and no exception remains."} -->
<!-- wp:amicited/checklist-item -->
<p>Open every internal link and confirm the destination exists.</p>
<!-- /wp:amicited/checklist-item -->
<!-- wp:amicited/checklist-item -->
<p>Confirm each anchor describes its destination out of context.</p>
<!-- /wp:amicited/checklist-item -->
<!-- wp:amicited/checklist-item {"required":false} -->
<p>Check campaign parameters on optional promotional links.</p>
<!-- /wp:amicited/checklist-item -->
<!-- wp:amicited/checklist-item -->
<p>Verify keyboard focus is visible on every linked control.</p>
<!-- /wp:amicited/checklist-item -->
<!-- /wp:amicited/checklist -->

Alle Adapter müssen die Quellreihenfolge, den Pflichtstatus, sichtbare Bezeichnungen, die Erledigungsbedingung und den ungeprüften Inhalt bewahren, wenn Scripting nicht verfügbar ist.

Beispiele

Gut: eine begrenzte Release-Prüfung

• Bestätigen Sie, dass die Release-Version mit dem genehmigten Änderungseintrag übereinstimmt.
• Führen Sie den dokumentierten Smoke-Test durch und fügen Sie das Ergebnis bei.
• Überprüfen Sie, ob der Rollback-Verantwortliche während des Release-Fensters verfügbar ist.
• Notieren Sie den Bereitstellungszeitpunkt im Vorfallzeitstrahl.

Erledigt, wenn: alle vier Aufzeichnungen vorhanden sind und der benannte Rollback-Verantwortliche das Fenster bestätigt hat.

Dies funktioniert, weil jedes Element mit einer beobachtbaren Aktion beginnt, innerhalb einer Release-Entscheidung bleibt und binäre Nachweise liefert. Die Erledigungszeile erklärt, was die vollständige Menge beweist.

Schlecht: eine wunschdenkende Inhaltsliste

• Denken Sie an die Zielgruppe.
• Gestalten Sie den Artikel ansprechend.
• Verbessern Sie SEO.
• Fügen Sie alles andere hinzu, was hilft.

Dies scheitert, weil keines der Elemente eine Bestehensbedingung definiert, „alles andere" die Menge unendlich macht und das Ankreuzen der Kästchen nicht beweisen würde, dass der Artikel fertig ist. Ersetzen Sie Wunschvorstellungen durch überprüfbare Prüfschritte wie „Nennen Sie eine primäre Zielgruppe im Briefing" oder verlagern Sie nicht handlungsorientierte Anleitungen in Fließtext.

Schema-Markup und Barrierefreiheit

Es gibt keinen allgemeinen Schema.org-Typ Checklist. Ordnen Sie unabhängige Prüfungen nicht HowToStep zu, es sei denn, die Seite beschreibt tatsächlich ein geordnetes Verfahren und der sichtbare Inhalt enthält diese Schritte. Eine Checkliste kann als sichtbarer Inhalt innerhalb von Article, TechArticle, Product oder einem anderen gerechtfertigten Seitentyp bleiben, aber ihre Kontrollkästchen schaffen keine zusätzliche Schema-Berechtigung.

Verwenden Sie native <input type="checkbox">-Steuerelemente für den interaktiven Zustand und verbinden Sie jedes Steuerelement mit einem <label> durch Umschließen oder passende for- und id-Werte. Eine statische Anzeige, die nicht geändert werden kann, darf sich nicht als aktiviertes Steuerelement tarnen. Verwenden Sie deaktivierte Kontrollkästchen für ein explizit nicht interaktives Beispiel oder eine Liste mit Textäquivalenten wie „Nicht geprüft" in Kontexten, in denen Formularsteuerelemente irreführend wären.

Tastaturnutzer müssen jedes aktivierte Kontrollkästchen in der Quellreihenfolge erreichen, es mit der Leertaste umschalten und einen dauerhaften Fokusindikator sehen können. Verschieben Sie den Fokus nicht nach einer Aktivierung. Wenn eine Fortschrittsmeldung aktualisiert wird, geben Sie eine prägnante Zusammenfassung wie „Vier von sechs Pflichtelementen erledigt" durch einen höflichen Live-Bereich bekannt; kündigen Sie nicht die gesamte Liste erneut an.

Aktivierte und deaktivierte Zustände erfordern mehr als Farbe. Bewahren Sie die Bezeichnung bei Aktivierung, anstatt sie durch „Erledigt" zu ersetzen, da die Aktion identifizierbar bleiben muss. Wenn Fortschritt gespeichert wird, erklären Sie den Speicherbereich und bieten Sie „Fortschritt zurücksetzen" an. Die nutzbaren Inhalte, Pflichtfeldmarkierungen und die Erledigungsbedingung müssen im serverseitig gerenderten HTML verbleiben, wenn JavaScript ausfällt.

Schreibregeln

Checklistenelemente sind knapp, weil der Leser ausführt oder überprüft, nicht das gesamte Thema innerhalb des Steuerelements lernt. Erklären Sie den Grund im umgebenden Prosa, bevor Sie die Regel nennen.

• Halten Sie eine Checkliste auf vier bis zehn Elemente. Vier etablieren eine nützliche endliche Menge; mehr als zehn werden schwer überschaubar und deuten auf mehrere Phasen hin.
• Halten Sie jede Aktion auf etwa 80 Zeichen und drei bis zwölf Wörter. Eine kurze Bezeichnung bleibt neben einem Steuerelement nutzbar und ohne umgebenden Prosa extrahierbar.
• Beginnen Sie mit einem spezifischen Imperativverb: Bestätigen, Öffnen, Vergleichen, Aufzeichnen, Testen, Anfügen oder Überprüfen. Vermeiden Sie schwache Verben wie Erwägen, Beachten oder Nachdenken.
• Geben Sie jedem Element eine Bestehensbedingung. „Titel und Links prüfen" kann teilweise bestanden werden, teilen Sie es daher in zwei Elemente auf.
• Halten Sie Elemente unabhängig. Wenn eine Aktion die nächste freischaltet, wandeln Sie das Verfahren in Schritte um und verwenden Sie die Checkliste nur zur abschließenden Überprüfung.
• Halten Sie Grammatik und Abstraktionsebene parallel. Mischen Sie nicht „Rechtliche Freigabe bestätigen" mit „Die Kampagne auf allen Kanälen veröffentlichen und eine Woche lang überwachen."
• Benennen Sie Nachweise, wenn die Erledigung nicht direkt sichtbar ist: den Bericht anhängen, den Zeitstempel aufzeichnen oder die Bestätigung des Genehmigenden einholen.
• Markieren Sie optionale Elemente explizit und schließen Sie sie vom erforderlichen Fortschritt aus. Optional muss bedeuten, dass die Erledigungsbedingung ohne sie wahr bleibt.
• Verwenden Sie Satzanfang und Schlussinterpunktion konsistent. Vollständige Sätze sind zu bevorzugen, wenn ein Element einen Zusatz enthält.

Setzen Sie niemals Folgendes in ein Checklistenelement:

• Mehrere geordnete Unterschritte, verzweigte Fehlerbehebungslogik oder eine zweite verschachtelte Checkliste.
• Eine Sicherheitswarnung, einen rechtlichen Haftungsausschluss oder eine irreversible Konsequenz, die vor der Handlung gesehen werden muss.
• Einen Absatz mit Erklärungen, ein langes Zitat, ein Erfahrungsbericht, einen Screenshot, ein Video, ein Formular oder einen werblichen Call-to-Action.
• Eine subjektive Bewertung, eine offene Wunschvorstellung, einen unbegründeten Schwellenwert oder eine Anforderung ohne beobachtbaren Nachweis.
• Einen Link, der nur mit „hier" bezeichnet ist, weil das Element ohne umgebenden Kontext extrahierbar bleiben muss.

Beitragstypen, die es verwenden

Die folgenden Verknüpfungen werden durch das postTypes-Frontmatter dieser Seite gesteuert. „Erforderlich" bedeutet, dass die Kernaufgabe des Beitragstyps von einem endlichen Erledigungsmodell abhängt; „empfohlen" und „optional" hängen vom Thema der Seite ab.

QA-Checkliste

Inhalt und Platzierung

• Die Überschrift benennt ein begrenztes Objekt, eine Entscheidung oder einen Bereitschaftszustand.
• Die Einleitung erklärt, was das Erledigen der erforderlichen Elemente beweist.
• Verwenden Sie vier bis zehn Elemente und teilen Sie größere Arbeiten in benannte Gruppen.
• Halten Sie jedes Element bei etwa 80 Zeichen und beginnen Sie mit einem konkreten Verb.
• Jedes Element hat eine beobachtbare Bestehensbedingung und kann unabhängig geprüft werden.
• Bestätigen Sie, dass das Umordnen von Elementen die Aufgabe nicht beeinträchtigt.
• Die Menge ist endlich und enthält jedes erforderliche Prüfkriterium für ihren angegebenen Umfang.
• Optionale Elemente sind sichtbar gekennzeichnet und vom erforderlichen Fortschritt ausgeschlossen.
• Entfernen Sie verschachtelte Verfahren, Warnungen, lange Erklärungen, Medien und Werbung.

Erledigt, wenn: die Sammlung einen begrenzten Zweck hat und jedes Element präzise, unabhängig und überprüfbar ist.

Rendering und Barrierefreiheit

• Die Erledigungsbedingung erscheint direkt nach dem letzten Element.
• Aktivierte Steuerelemente haben zugehörige Bezeichnungen, Tastaturbedienung und sichtbaren Fokus.
• Der Zustand wird nicht allein durch Farbe, Symbole, Durchstreichung oder Position vermittelt.
• Interaktiver Fortschritt funktioniert ohne Fokusverschiebung und erklärt etwaige Speicherung.
• Bezeichnungen und Erledigungskriterien bleiben ohne CSS oder JavaScript verfügbar.
• Behalten Sie strukturierte Daten auf der umschließenden Seite; erfinden Sie kein Checklist-Schema.
• Bewahren Sie dieselben Felder und die Reihenfolge in allen drei Plattformzuordnungen.
• Behalten Sie Screenshot-Kommentare als Anweisungen bei; verweisen Sie auf kein fehlendes Bild.

Erledigt, wenn: Zustand, Bezeichnungen, Reihenfolge und Erledigungsbedeutung in jedem unterstützten Rendering-Pfad erhalten bleiben.

FAQ

Die Academy-Vorlage rendert die fünf geprüften Fragen aus dem [[faq]]-Frontmatter dieser Seite. Sie behandeln die Anzahl der Elemente, die Abgrenzung zu Aufzählungs- und Schrittlisten, gespeicherte Zustände und strukturierte Daten.