Eine Fehlerbericht-Vorlage,
die Sie kopieren können.

Eine gute Fehlerbericht-Vorlage bringt Entwickler in einem Durchgang vom Lesen zum Reproduzieren: was passiert ist, was erwartet wurde, die Schritte und wo. Kopieren Sie die Vorlage unten in ein Dokument, ein Formular oder einen Issue-Tracker, oder richten Sie dieselben Felder auf einem Board ein, das auch die Dateien annimmt.

Die Fehlerbericht-Vorlage

Sieben Fragen. Pflicht sollten der Titel und die Schritte sein; der Rest bleibt optional.

Titel
  Was kaputt ist und wo. Eine Zeile.
  Beispiel: CSV-Export lädt eine leere Datei herunter

Was ist passiert?
  Was Sie gesehen haben, in ein oder zwei Sätzen.

Was haben Sie erwartet?
  Was stattdessen hätte passieren sollen.

Schritte zum Reproduzieren
  1.
  2.
  3.

Wie oft?
  Jedes Mal, manchmal oder einmal.

Wo?
  Browser oder App-Version, Betriebssystem, Konto oder Workspace.

Können Sie etwas zeigen?
  Ein Screenshot, eine Bildschirmaufnahme, ein Log, eine HAR-Datei.

Ein Bug Report als Beispiel

Dieselbe Vorlage, ausgefüllt. Produkt und Zahlen sind erfunden.

Titel
  CSV-Export lädt eine leere Datei herunter

Was ist passiert?
  Ich habe auf der Seite Berichte auf Exportieren geklickt.
  Eine Datei wurde heruntergeladen, sie enthält aber nur die Kopfzeile.

Was haben Sie erwartet?
  Die 214 Zeilen, die die Tabelle auf dem Bildschirm zeigt.

Schritte zum Reproduzieren
  1. Berichte öffnen und die letzten 30 Tage wählen.
  2. Nach dem Tarif „Scale“ filtern.
  3. Auf Exportieren klicken, dann auf CSV.

Wie oft?
  Jedes Mal, wenn der Filter aktiv ist. Ohne ihn klappt der Export.

Wo?
  Chrome 141 unter macOS 15. Workspace: northwind.

Können Sie etwas zeigen?
  export.csv (die leere Datei), reports.har

Wozu jedes Feld da ist

  1. Titel. Was kaputt ist und wo, damit sich der Bericht wiederfinden lässt und Duplikate zueinanderfinden.
  2. Was ist passiert? Das Symptom in den Worten dessen, der es meldet, bevor jemand es deutet.
  3. Was haben Sie erwartet? Die Hälfte aller Berichte ist ein Missverständnis, und diese Zeile zeigt, welche Hälfte.
  4. Schritte zum Reproduzieren. Der Teil, den kein Entwickler erraten kann. Nummeriert, eine Aktion pro Schritt.
  5. Wie oft? „Jedes Mal“ deutet auf die Logik, „manchmal“ auf Timing oder Daten.
  6. Wo? Browser, Version und Konto grenzen die Suche stärker ein als jede Beschreibung.
  7. Können Sie etwas zeigen? Eine Aufnahme oder ein Log ersetzt drei Absätze.

Aus der Bug-Report-Vorlage ein Formular machen

Ein Formular für Fehlerberichte sollte weniger abfragen als die Vorlage. Jedes Pflichtfeld kostet einige Berichte, und ein Bericht, der fehlt, kostet mehr als ein Detail, das fehlt.

  • Machen Sie den Titel und die Schritte zum Reproduzieren zur Pflicht, sonst nichts.
  • Setzen Sie in den Platzhalter jedes Feldes ein Beispiel, damit man sieht, wie genau Sie es wissen wollen.
  • Zeigen Sie ähnliche Berichte vor dem Absenden, damit eine Stimme entsteht und kein Duplikat.
  • Lassen Sie zu, dass man Dateien ins Formular zieht.
  • Sagen Sie, wie es weitergeht: wo der Bericht erscheint und auf welchem Weg die Antwort kommt.

Was man einem Fehlerbericht anhängt

Belege verkürzen das Gespräch. Um diese Dateien lohnt es sich zu bitten, und das klärt jede von ihnen:

  • Ein Screenshot, für alles, was man sehen kann.
  • Eine Bildschirmaufnahme als MP4, wenn sich die Schritte schwer in Worte fassen lassen.
  • Eine HAR-Datei, wenn eine Seite nicht lädt, nicht speichert oder nicht exportiert.
  • Ein Konsolen- oder Server-Log als TXT oder LOG.
  • Die E-Mail selbst als EML, bei Problemen mit Zustellung und Formatierung.
  • Die CSV-, XLSX- oder JSON-Datei, die sich nicht importieren ließ, oder die, die falsch herauskam.

Fehlerberichte auf einem Kjerr-Board sammeln

Ein Kjerr-Board kann die Fragen der Vorlage stellen und die Belege aufnehmen. Das Feedback-Management dahinter zeigt dem Team, was neu ist.

  • Das Formular ist anpassbar: Legen Sie „Schritte zum Reproduzieren“, „Erwartet“ und „Wo“ als eigene Felder an, insgesamt bis zu 10 Felder, jedes Pflicht oder optional und mit eigenem Platzhalter.
  • Bis zu 5 Dateien mit je 10 MB an einem Bericht oder Kommentar: Bilder, PDF, EML, TXT, LOG, CSV, JSON, HAR, ZIP, DOCX, XLSX, PPTX und MP4.
  • Ähnliche Berichte erscheinen beim Tippen des Titels, jeder mit Abstimmen-Button.
  • Für ein QA-Board stellen Sie es auf „nur für angemeldete Nutzer“ und beschränken die Anmeldung auf die E-Mail-Domain Ihres Unternehmens, so wie bei einem digitalen Ideenbriefkasten.
  • Wechselt der Status auf Shipped, bekommen der Melder und alle Abstimmenden eine E-Mail.
  • Ein Issue-Tracker ist es nicht: keine Zuständigen, keine Schweregrade, keine Sprints.

Fragen, klar beantwortet.

Was ist eine Fehlerbericht-Vorlage?

Eine Fehlerbericht-Vorlage, englisch Bug Report Template, ist ein fester Satz von Fragen, der aus jedem Bericht dieselben Fakten herausholt: was passiert ist, was erwartet wurde, die Schritte zum Reproduzieren und wo der Fehler auftrat. So kommen Entwickler vom Lesen zum Reproduzieren, ohne eine Runde Rückfragen.

Was gehört in einen Fehlerbericht?

Ein einzeiliger Titel, was passiert ist, was erwartet wurde, nummerierte Schritte zum Reproduzieren, wie oft der Fehler auftritt, die Umgebung und Belege wie ein Screenshot oder ein Log. Können nur zwei Dinge Pflicht sein, dann der Titel und die Schritte.

Was ist der Unterschied zwischen einem Bug Report und einem Feature-Request?

Ein Bug Report sagt, dass das Produkt nicht tut, was es verspricht. Ein Feature-Request bittet um etwas, das es nie versprochen hat. Beide brauchen unterschiedliche Fragen; für den zweiten gibt es die Feature-Request-Vorlage.

Wie schreibe ich gute Schritte zum Reproduzieren?

Beginnen Sie bei einem Zustand, den jeder erreichen kann, schreiben Sie eine Aktion pro Zeile und nennen Sie die genauen Werte, die Sie eingegeben oder ausgewählt haben. Hören Sie bei dem Schritt auf, an dem das Problem auftritt. Ist ein Schritt nur manchmal nötig, schreiben Sie es dazu.

Was ist eine HAR-Datei, und sollte ich eine anhängen?

Eine HAR-Datei ist eine Aufzeichnung der Anfragen, die eine Webseite gestellt hat, gespeichert aus den Entwicklertools des Browsers. Hängen Sie eine an, wenn eine Seite nicht lädt, nicht speichert oder nicht exportiert. Sehen Sie sie vorher durch: Sie kann Session-Cookies und personenbezogene Daten enthalten.

Kann Kjerr einen Bug-Tracker ersetzen?

Nein. Kjerr sammelt Berichte, entfernt Duplikate und sagt denen, die einen Fehler gemeldet haben, wenn sich der Status ändert. Es hat keine Zuständigen, keine Schweregrade und keine Sprints und gleicht sich nicht mit Jira oder Linear ab. Teams nutzen es als Eingangstür und behalten ihren Issue-Tracker dahinter.

Verwandte Seiten

Feature-Request-VorlageVorlage zum Kopieren und die Felder für Ihr Formular
Feedback-ManagementEine Inbox für jedes Teammitglied
Was ist ein Feedback-BoardWoraus es besteht und wann es funktioniert
Kundenfeedback sammelnSieben Schritte, der Reihe nach

Geben Sie Ihren Nutzern eine Antwort.

Während der Early-Access-Phase ist Kjerr kostenlos: alle Funktionen, keine Kreditkarte. Kostenpflichtige Tarife werden später pro Workspace berechnet, nie pro Admin-Seat.