Bug-Entdecken Leitfaden
Aus MDC
Wenn sie mit Mozilla-Software Hilfe benötigen (zum Beispiel Firefox oder Thunderbird), brauchen sie bitte den Support. Ändern sie diese Seite nicht.
Wenn Sie neu bei der Mozilla Qualitätssicherung sind, können sie versuchen, von den erfahreneren Mitarbeiter hilfe zu erhalten. Gehen sie zur Community-Sektion auf der Qualitätssicherung-Page. Wenn sie eine Firefox-Bug melden wollen, können sie auch im #firefox-IRC-Channel Hilfe suchen. Dort gibt es auch einn Artikel speziell zu filing Firefox bugs.
Inhaltsverzeichnis |
[bearbeiten] Grundsätze
Am liebsten werden genaue Bug-Medungen behoben. Dieser Leitfaden erklärt, wie Sie solche Berichte schreiben sollten.
- Seien Sie präzis
- Seien Sie klar - erklären Sie so, dass die anderen Ihren Bug nachvollziehen können
- Beschreiben Sie nur einen Bug pro Meldung
- Kein Bug ist zu banal, um gemeldet zu werden - kleine Bugs könnten grössere verstecken
- Trennen Sie fakten klar von Vermutungen ab
- Schreiben Sie die Bug-Meldung wenn möglich in Englisch
[bearbeiten] Einleitung
- Reproduzieren Sie ihren Bug, indem Sie die neueste Version der Software benützen, um zu sehen, ob der Bug schon behoben wurde.
- Suchen sie in Bugzilla, um zu sehen, ob ihr Bug schon gemeldet wurde
(Tutorial).
[bearbeiten] Einen neuen Bug melden
Wenn Sie den Bug in einer neuen Version reproduziert haben und noch niemand den Bug gemeldet hat, dann:
- Wählen Sie "Einen neuen Bug melden"
- Falls Sie noch keinen Bugzilla-Account haben, erstellen Sie hier einen
- Loggen Sie sich ein
- Wählen Sie das Produkt, in welchem Sie den Bug gefunden haben
- Füllen Sie das Formular aus. Hier ist eine kleine Hilfe, es zu verstehen:
Component: In welchem Teil der Software besteht der Bug?
Dieses Feld ist benötigt. Klicken Sie auf "Component" um ein Beschrieb aller Komponenten zu sehen. Falls keine Angebracht scheint, suchen Sie nach einer "General" Komponente.
OS: Auf welchem Betriebssywstem haben Sie den Bug gefunden? (z.B. Linux, Windows XP, Mac OS X)
Wenn Sie wissen, dass der Bug auf mehreren Betriebssystemen besteht, klicken Sie "All". Wenn ihr Betriebssystem nicht aufgelistet ist, klicken Sie auf "Other".
Summary: Wie würden Sie den Bug beschreiben, möglichst in 60 oder weniger Buchstaben?
Eine gute Kurzfassung sollte eine Bug-Meldung schnell und unverwechselbar beschreiben. Sie sollte das Problem erklären, nicht ihre vorgeschlagen Hilfe.
- Gut: "Einen Dateikopierdialog zu beenden crasht den Dateimanager"
- Schlecht: "Software crashes"
- Schlecht: "Browser sollte auf meiner Website gehen."
Description: Die Details ihrer Bug-Meldung, einschliesslich:
Overview: Detailliertere Beschreibung der Zusammenfassung.
Durch ziehen gewählte Pages crasht Mac-Versionen in der NSGetFactory-Funktion.
Steps to Reproduce: Kleine, einfache schritte, um den Bug Nachzumachen
1) View any web page. (I used the default sample page,
resource:/res/samples/test0.html)
2) Drag-select the page. (Specifically, while holding down
the mouse button, drag the mouse pointer downwards from any
point in the browser's content region to the bottom of the
browser's content region.)
Actual Results: Was die Applikation machte, nachdem Sie die oben aufgeführten Schtritte durchgeführt haben.
The application crashed.
Expected Results: Was die Applikation hätte tun sollen, wenn der Bug nicht da wäre
The window should scroll downwards. Scrolled content should be selected.
(Or, at least, the application should not crash.)
Build Date & Platform: Datum und Betriebssystem auf dem die Applikation lief, als sie den Bug zum ersten mal gesehen haben.
Build 2006-08-10 on Mac OS 10.4.3
Additional Builds and Platforms: Falls Sie wissen, dass der Bug auch in anderen Betriebssystemen auftritt, schreiben Sie dies.
Doesn't Occur On Build 2006-08-10 on Windows XP Home (Service Pack 2)
Additional Information: Andere wichtige Informationen.
Für crashing-Bugs
- Win32: Wenn Sie einen Dr. Watson-Fehler erhalten, notieren Sie bitte den Typ des Crashs und das Module in welchem die Applikation crashte (z.B. access violation in mozilla.exe)
- Mac OS X: wenn die Applikation crasht, klicken Sie den Report-Button im Bestätigungsfenster, das erscheint, kopieren Sie dann den ganzen Text, der unter der Nachricht "Problem and system information" erscheint und kopieren Sie ihn in ihre Bug-Meldung. Sie müssen die Meldung nicht an Apple senden, also klicken Sie nur auf den roten "Close"-Button am oberen Rand des Fensters
- Unix: Bitte providen Sie eine minimierte Stack-Trace, welche generiert werden kann, indem Sie gdb mozilla core in eine Shell-Eingabe eingeben.
Date/Time: 2006-12-26 12:15:20.089 -0500
OS Version: 10.4.8 (Build 8L2127)
Report Version: 4
Command: firefox-bin
Path: /Applications/Firefox.app/Contents/MacOS/firefox-bin
Parent: WindowServer [71]
Version: 2.0.0.1 (2.0.0.1)
PID: 114
Thread: 0
Exception: EXC_BAD_ACCESS (0x0001)
Codes: KERN_PROTECTION_FAILURE (0x0002) at 0x000000ca
Thread 0 Crashed:
0 libxpcom_core.dylib 0x0186329b AppendUTF8toUTF16(char const*, nsAString_internal&) + 31
1 libxpcom_core.dylib 0x01822916 nsTextFormatter::smprintf_free(unsigned short*) + 3248
... (many many more lines like this) ...
Add an attachment: Sie können relevante Dateien an ihre Bug-Meldung anfügen. Debugging-Informationen, die länger als 20 Zeilen sind, sollten auf diesem Weg geliefert werden. Sollten Sie eine HTML-Datei haben, die diesen Bug beschreibt, sollten Sie es anfügen. Sie können anfänglich nur eine Datei anfügen. Sollte ihre Meldung mehr Dateien angehängt haben, besuchen Sie den neu hinzugefügten Bug später noch einmal, um das zu tun. Hängen Sie zuerst untergeordnete Dateien an (z.B. Bilder) und ändern Sie anschliessend die HTML-Datei, sodass die Demo unabhängig ist. Fragen Sie, bevor Sie mehr als 5 Dateien angängen.
Prüfen Sie ihren Report zweimal auf Fehler und drücken Sie dann "Commit". Ihre Bug-Meldung wird nun in die Bugzilla-Datenbank kommen.
[bearbeiten] Original document information
- Author(s): Gervase Markham, based on an original by Eli Goldberg
- Other Contributors: Claudius Gayle, Jan Leger, Felix Miata, Peter Mock, Chris Pratt, Chris Yeh, and others.
- Translation English-German by Lukas Diener