MDPress

Entwicklung

Bug-Report-Vorlage in Markdown

Ein Fehler wird schneller behoben, wenn jemand anderes ihn beim ersten Versuch nachvollziehen kann. Diese Vorlage gibt den Fakten eine feste Reihenfolge: eine Zusammenfassung in einem Satz, die Umgebung, nummerierte Schritte, was du erwartet hast, was passiert ist, und die Belege. Fülle sie aus und exportiere ein PDF.

Diese Vorlage im Editor öffnen
Kategorie
Entwicklung
Standardstil
Technisch

Wann du sie brauchst

Nutze sie, wenn ein Problem über deinen Tracker hinaus weitergegeben werden muss: an einen Anbieter, eine Kundin, einen Support oder eine Führungskraft, die einen Nachweis braucht. Die Leserin oder der Leser ist meist eine Entwicklerin oder ein Tester, der nicht dabei war, als der Fehler auftrat. Jeder Abschnitt beantwortet also eine Frage, die sonst extra gestellt werden müsste.

Was enthalten ist

  • Ein Kopfbereich mit Ausfüllfeldern für Projekt, deinen Namen und das Datum, plus eine Zeile für den Schweregrad.
  • Eine Umgebungstabelle für App-Version, Browser und Betriebssystem sowie Gerätetyp.
  • Nummerierte Schritte zur Reproduktion, erwartetes und tatsächliches Verhalten, Belege und einen Abschnitt für Workarounds.

Tipps für ein besseres Dokument

  • Kopiere den genauen Fehlertext, statt ihn zu beschreiben. Füge Log-Auszüge in einen Codeblock ein, damit die Einrückung erhalten bleibt, und entferne vorher Zugangsdaten und persönliche Angaben.
  • Kürze die Schritte auf das Minimum, das den Fehler noch auslöst. Die Vorlage öffnet im Stil Technisch, der Tabellen und Code gut lesbar hält.

Vorlagenvorschau

Bug-Report: Projekt oder Thema

Gemeldet von: Dein Name · Datum: Datum
Schweregrad: Niedrig / Mittel / Hoch

Zusammenfassung

Beschreibe das Problem in einem Satz, inklusive der Aktion, die es auslöst.

Umgebung

DetailWert
App-VersionVersion eintragen
Browser / BetriebssystemDetails eintragen
GerätDesktop / Mobil

Schritte zur Reproduktion

  1. Die betreffende Seite öffnen.
  2. Die minimal nötige Eingabe machen.
  3. Die Aktion ausführen.

Erwartetes Verhalten

Beschreibe, was passieren sollte.

Tatsächliches Verhalten

Beschreibe, was passiert, inklusive des genauen Fehlertexts.

Belege

Füge einen Screenshot oder einen bereinigten Log-Auszug hinzu. Entferne Zugangsdaten und personenbezogene Daten.

Workaround

Halte einen vorübergehenden Workaround fest, falls vorhanden.

Ausfüllfelder wie dein Name und das Datum werden ersetzt, sobald du die Vorlage im Editor öffnest.