Häufig ist es hilfreich, Informationen im Kontext zu gruppieren, um Personen dabei zu helfen, eine komplexe Aufgabe zu erledigen, eine Reihe zusammenhängender Aufgaben zu verstehen oder einen gesamten Workflow zu veranschaulichen. Verwenden Sie längere Artikel, in denen Inhaltstypen kombiniert werden, um sicherzustellen, dass Benutzerinnen kontextbezogene Inhalte an der richtigen Stelle finden. Längere Artikel tragen auch dazu bei, die Duplizierung von Inhalten zu vermeiden und die Skalierung zu ermöglichen, wenn dem Produkt weitere Optionen hinzugefügt werden. Längere Artikel eignen sich meistens dann, wenn Benutzerinnen das Produkt aktiv nutzen und an verschiedenen Stellen des Lernprozesses auf Inhalte im Artikel zugreifen müssen.
Kombinieren mehrerer Inhaltstypen in einem Artikel
- Verwenden Sie in einem längeren Artikel konzeptionelle, prozedurale oder referenzielle Inhalte sowie Inhalte zur Problembehandlung oder zu bekannten Problemen, und verwende keine Schnellstartanleitungen oder Tutorials.
- Verwenden Sie im Artikel je nach Bedarf Abschnitte mit unterschiedlichen Inhaltstypen, und befolge die Titelrichtlinien für den Inhaltstyp.
- In den meisten Fällen enthalten diese Artikel mindestens einen prozeduralen Abschnitt sowie mindestens einen zusätzlichen konzeptionellen, referenziellen oder prozeduralen Abschnitt.
- Verwenden Sie die Richtlinien für die Inhaltsreihenfolge, um Überschriften innerhalb des Artikels zu organisieren.
- Baue so häufig wie möglich Informationen zur Problembehandlung ein.
- Sie können den Titel des Artikels bei Bedarf in einer Überschrift replizieren.
Titelrichtlinien für Artikel, die mehrere Inhaltstypen kombinieren
- Wenn im Artikel eine Prozedur enthalten ist, verwende einen aufgabenbasierten Titel, der mit einem Gerundium beginnt.
- Titel sind allgemein genug, um den Informations- und Aufgabenbereich des Artikels zu beschreiben.
- Titel beschreiben die zu ändernde Einstellung und hängen nicht davon ab, welche Einstellung die Leser*innen auswählen (z. B. „Festlegen der Sichtbarkeit von Repositorys“ im Vergleich zu „Veröffentlichen eines privaten Repositorys“).