Zum Hauptinhalt springen

FAQ-Seiten erstellen

FAQ-Seiten bündeln wiederkehrende Fragen an einer Stelle. Gut gemacht reduzieren sie Suchaufwand, Support-Tickets und Missverständnisse.

Wichtigste Regel

Leser:innen sollen die passende Frage finden, ohne erst viel Text lesen zu müssen.

Struktur: Kategorien statt Endlosliste​

  • Thematisch clustern

    Sortieren Sie Fragen in klare Oberkategorien (substantivische Begriffe).

    Beispiel:

    • Zugang & Rollen
    • Inhalte & Redaktion
    • Veröffentlichung & Preview
    • Barrierefreiheit
    • Datenschutz & Rechtliches

  • „User Journey“ nutzen

    Strukturieren Sie nach typischen Phasen: vor dem Start, während der Arbeit, bei Problemen, nach der Veröffentlichung.

  • 5–7 Fragen pro Kategorie anstreben

    Wenn es mehr werden, ergänzen Sie Unterkategorien oder splitten Sie in mehrere Seiten.

Priorisieren: „Häufig gesucht“ nach oben​

Nicht alle Fragen sind gleich wichtig. Platzieren Sie die häufigsten Fragen (z. B. aus Support-Tickets) ganz oben, bevor die Kategorien beginnen.

Darstellung: Akkordeon und Navigation​

FAQ-Antworten sollten erst bei Bedarf sichtbar werden, damit die Seite gut scannbar bleibt.

<Details summary="Passwort vergessen – was tun?">
  Nutzen Sie zuerst die „Passwort vergessen“-Funktion. Wenn Sie keinen Zugriff auf die E-Mail-Adresse haben, wenden Sie sich an Ihre zuständige Stelle.
</Details>

Ausgabe:

Passwort vergessen – was tun?

Nutzen Sie zuerst die „Passwort vergessen“-Funktion. Wenn Sie keinen Zugriff auf die E-Mail-Adresse haben, wenden Sie sich an Ihre zuständige Stelle.

Bei sehr langen Seiten hilft zusätzlich ein Inhaltsverzeichnis (TOC). Docusaurus erzeugt dafür automatisch eine On-Page-Navigation (rechte Sidebar) auf Basis Ihrer Überschriften.

Wording: Fragen so formulieren, wie Nutzer:innen denken​

  • Ich-Perspektive bevorzugen: „Wie kann ich …?“ statt „Rückgabemodalitäten“
  • Front-Loading: Wichtigstes Keyword an den Anfang, z. B. „Preview-URL – wo finde ich sie?“
  • Eine Frage, ein Problem: Keine „Sammelfragen“ mit mehreren Themen

Inhalt: Antworten kurz, verlässlich, weiterführend​

  • Starten Sie mit der direkten Antwort (1–2 Sätze), ergänzen Sie Details optional (z. B. per &lt;Details summary="…"&gt;…&lt;/Details&gt;)
  • Verlinken Sie danach auf die passende Stelle der Dokumentation („Weiterlesen“), statt alles zu duplizieren
  • In Verwaltungs-Kontexten: Benennen Sie Zuständigkeit, Rechtsbezug und Kontaktweg klar (ohne absolute Zusagen)