Debugging-Notizen in einen reproduzierbaren Fehlerbericht umwandeln
Ein guter Fehlerbericht ermöglicht anderen, das Problem zu verstehen und seine Reproduktion zu versuchen. Geordnete Notizen helfen, Belege von Theorien zu trennen, die beim Debugging entstanden sind.
Beginne mit dem richtigen Material.
- Was du bereitstellst
- vom Nutzer bereitgestellte Notizen zur Fehlerreproduktion und Beobachtungen auf der aktuellen Seite.
- Das beabsichtigte Ergebnis
- Speichere ein strukturiertes Issue mit tatsächlichen Belegen und noch ungeklärten Details zur Reproduktion.
So funktioniert der Ablauf.
Erfasse Umgebung, Reproduktionsschritte, erwartetes und tatsächliches Verhalten sowie bereitgestellte Logs oder Verweise. Kennzeichne unsichere Beobachtungen und bewahre den genauen Fehlertext, wo er relevant ist.
Was du am Ergebnis prüfen solltest.
Prüfe, ob andere genügend Informationen haben, um das Szenario auszuprobieren. Fehlende Versionen oder Schritte müssen offene Fragen bleiben, und eine ungeprüfte Hypothese darf nicht als Grundursache bezeichnet werden.
Prüfe in der Markdown-Vorschau neben dem Text auch Überschriften, Listen und Links. Bewahre Quellenverweise im Dokument auf, damit Prüfer wichtige Aussagen auf dein bereitgestelltes Material zurückführen können.
Lerne am ausgearbeiteten Beispiel.
Das herunterladbare Markdown-Beispiel zeigt eine mögliche Gliederung des Ergebnisses. Lies es neben dem Quellbeispiel und unterscheide dokumentierte Fakten, vorgeschlagene Formulierungen und noch offene Fragen.
Das bereitgestellte Beispiel dient zur Veranschaulichung. Es ist kein aufgezeichneter Durchlauf mit deinen Daten.
Beispiel herunterladen ↓Nutze es mit deinem eigenen Material.
- Öffne die gewünschte Quelle und aktiviere WebAct in diesem Tab.
- Kopiere die Aufgabe aus dem oberen Seitenbereich, ergänze nötige Felder oder Wünsche und prüfe die vorgeschlagenen Aktionen.
- Vergleiche das erste Ergebnis mit deiner Quelle. Bitte bei Bedarf um eine konkrete Korrektur oder Verfeinerung.