Fehlerbericht Vorlage
Füllen Sie die Felder aus und kopieren Sie den fertigen Fehlerbericht als Markdown oder als reinen Text. Alles läuft in Ihrem Browser, nichts wird an uns gesendet.
Vorlage ausfüllen
Ihr Fehlerbericht
Beide Fassungen aktualisieren sich beim Tippen. Kopieren Sie die, die Ihr Ticketsystem annimmt.
# Fehlerbericht
## Titel
[Klarer, aussagekräftiger Titel - was ist kaputt und wo]
## Beschreibung
[Kurzer Überblick über das Problem - 1-2 Sätze]
## Schritte zur Reproduktion
1. [Erster Schritt - von einem bekannten Zustand aus]
2. [Zweiter Schritt - Aktionen genau benennen]
3. [Dritter Schritt - verwendete Daten und Werte angeben]
4. [Weitere Schritte nach Bedarf]
5. [Letzter Schritt, der den Fehler auslöst]
## Erwartetes Verhalten
[Was laut Design oder Logik passieren sollte]
## Tatsächliches Verhalten
[Was tatsächlich passiert - Symptome beschreiben]
## Umgebung
- **Browser:** [Name und Version]
- **Betriebssystem:** [System und Version]
- **Gerät:** [Desktop oder Mobilgerät und Modell]
- **Bildschirmauflösung:** [bei Layoutfehlern]
- **Anmeldestatus:** [an- oder abgemeldet, Rolle]
## Visuelle Belege
[Screenshots oder Video anhängen]
- Screenshot 1: [Beschreibung]
- Screenshot 2: [Beschreibung]
- Video: [Link oder Anhang]
## Konsolenfehler
```
[Fehler aus der Browserkonsole einfügen - F12 → Konsole]
```
## Netzwerkprobleme
[Fehlgeschlagene API-Aufrufe aus dem Netzwerk-Tab - F12 → Netzwerk]
## Auswirkung und Schweregrad
- **Schweregrad:** [kritisch/hoch/mittel/niedrig]
- **Betroffene Nutzer:** [alle / mobile Nutzer / bestimmte Rolle / usw.]
- **Geschäftliche Folgen:** [Umsatzverlust / Supportaufwand / usw.]
- **Umgehung:** [ja/nein - wenn ja, beschreiben]
## Weiterer Kontext
- **Häufigkeit:** [jedes Mal / manchmal / selten]
- **Seit wann:** [gerade eben / seit dem Update / seit [Datum]]
- **Verwandte Meldungen:** [Links zu ähnlichen Fehlern]
- **Sonstiges:** [alles Weitere, was hilft]
## Checkliste
- [ ] Ich habe es in einer sauberen Umgebung getestet (Inkognito- oder privates Fenster)
- [ ] Ich habe die Schritte zum Nachvollziehen angegeben
- [ ] Ich habe Angaben zur Umgebung gemacht
- [ ] Ich habe Screenshots oder ein Video angehängt
- [ ] Ich habe die Konsole auf Fehler geprüft
- [ ] Ich habe geprüft, ob der Fehler schon gemeldet wurdeFEHLERBERICHT
=============
TITEL
-----
[Klarer, aussagekräftiger Titel - was ist kaputt und wo]
BESCHREIBUNG
------------
[Kurzer Überblick über das Problem - 1-2 Sätze]
SCHRITTE ZUR REPRODUKTION
-------------------------
1. [Erster Schritt - von einem bekannten Zustand aus]
2. [Zweiter Schritt - Aktionen genau benennen]
3. [Dritter Schritt - verwendete Daten und Werte angeben]
4. [Weitere Schritte nach Bedarf]
5. [Letzter Schritt, der den Fehler auslöst]
ERWARTETES VERHALTEN
--------------------
[Was laut Design oder Logik passieren sollte]
TATSÄCHLICHES VERHALTEN
-----------------------
[Was tatsächlich passiert - Symptome beschreiben]
UMGEBUNG
--------
- **Browser:** [Name und Version]
- **Betriebssystem:** [System und Version]
- **Gerät:** [Desktop oder Mobilgerät und Modell]
- **Bildschirmauflösung:** [bei Layoutfehlern]
- **Anmeldestatus:** [an- oder abgemeldet, Rolle]
VISUELLE BELEGE
---------------
[Screenshots oder Video anhängen]
- Screenshot 1: [Beschreibung]
- Screenshot 2: [Beschreibung]
- Video: [Link oder Anhang]
KONSOLENFEHLER
--------------
```
[Fehler aus der Browserkonsole einfügen - F12 → Konsole]
```
NETZWERKPROBLEME
----------------
[Fehlgeschlagene API-Aufrufe aus dem Netzwerk-Tab - F12 → Netzwerk]
AUSWIRKUNG UND SCHWEREGRAD
--------------------------
- **Schweregrad:** [kritisch/hoch/mittel/niedrig]
- **Betroffene Nutzer:** [alle / mobile Nutzer / bestimmte Rolle / usw.]
- **Geschäftliche Folgen:** [Umsatzverlust / Supportaufwand / usw.]
- **Umgehung:** [ja/nein - wenn ja, beschreiben]
WEITERER KONTEXT
----------------
- **Häufigkeit:** [jedes Mal / manchmal / selten]
- **Seit wann:** [gerade eben / seit dem Update / seit [Datum]]
- **Verwandte Meldungen:** [Links zu ähnlichen Fehlern]
- **Sonstiges:** [alles Weitere, was hilft]
CHECKLISTE
----------
- [ ] Ich habe es in einer sauberen Umgebung getestet (Inkognito- oder privates Fenster)
- [ ] Ich habe die Schritte zum Nachvollziehen angegeben
- [ ] Ich habe Angaben zur Umgebung gemacht
- [ ] Ich habe Screenshots oder ein Video angehängt
- [ ] Ich habe die Konsole auf Fehler geprüft
- [ ] Ich habe geprüft, ob der Fehler schon gemeldet wurdeDas läuft in Ihrem Browser. Nichts, was Sie einfügen oder öffnen, wird an uns gesendet.
Wofür jedes Feld da ist
Eine Fehlerbericht Vorlage lohnt sich, weil sie Rückfragen erspart. Titel und Beschreibung sagen einer Entwicklerin, ob der Bericht sie betrifft. Die Schritte, das erwartete und das tatsächliche Verhalten machen den Fehler nachvollziehbar. Umgebung, visuelle Belege und Konsolenfehler werden am häufigsten ausgelassen, und genau sie entscheiden, ob der Fehler heute behoben wird oder erst nach einer Woche Nachfragen.
Was einen guten Fehlerbericht ausmacht
Schreiben Sie die Schritte von einem Zustand aus, den die Leserin selbst erreichen kann, und nennen Sie die eingegebenen Werte genau. Beschreiben Sie Symptome statt Ursachen, denn eine falsche Diagnose schickt die Behebung in die falsche Richtung. Ein Fehler gehört in einen Bericht. Und lassen Sie nichts weg, weil es selbstverständlich wirkt: Browserversion, Bildschirmgröße und ob Sie angemeldet waren, erklären oft, warum sonst niemand das Problem sieht.
Die Erweiterung füllt die Hälfte davon selbst aus
Session Replay erfasst die Umgebung, die Konsolenfehler und die visuellen Belege von der Seite, auf der der Fehler aufgetreten ist. Drei dieser Felder stehen also schon fest, bevor Sie den Bericht öffnen.