weil ich es für einen anderen Zweck mal aufgeschrieben habe, möchte ich hier einige Tipps für eine gute Fehlermeldung (oder einen sonstigen Problembericht), die auch von anderen gelesen und verstanden wird, weitergeben:
"Eine gute Fehlerbeschreibung erleichtert dem Entwickler das Finden des Fehlers und verhindert unnötige Diskussionen."
- Zusammenfassen: Knackige Überschrift, nicht zu allgemein (nicht z.B. "3D-Drucker kaputt" sondern "3D Drucker ruckartige Bewegung in der Y-Achse"
- Reproduzierbar: Kürzesten Weg zum Fehler beschreiben
- Isolieren und Verallgemeinern: Bedingungen möglichst genau eingrenzen (z.B. "tritt nur mit blauem Filament auf")
- Kurz, aber eindeutig und vollständig. Schreibfehler vermeiden!
- Keine Theorien zur Fehlerursache, die nichts mit der Beschreibung zu tun haben (vor allem bei Software).
- Neutral, keine Anschuldigungen. (nicht "Mit Baufix hätte ich so einen Ärger nie.")
Gruß
Esther