User:Nnino/Drafts/BugReportsBetter

Vorbemerkung

 * Fehler müssen den Entwicklern möglichst eindeutig und klar nachvollziehbar gemeldet werden. Dazu wird das Fehlerverfolgungssystem Bugzilla auf libreoffice.org eingesetzt.
 * Das Aufspüren und Beheben von Fehlern kann eine komplexe und schwierige Angelegenheit sein, die viel Können und Durchhaltevermögen von allen Seiten erfordert. Ggf. muss über längere Zeit mit den Entwicklern kommuniziert werden, um den Fehler exakt zu beschreiben und ein- bzw. abzugrenzen.
 * Um auch Anfänger zu ermutigen, Fehler zu melden, sind unterschiedliche Einstiegspunkte möglich, auf die im folgenden Abschnitt hingeführt wird.

Einstiegspunkte
Je nach Ihrer Fachkompetenz und Ihrem Sprachvermögen können Sie einen Bug direkt auf Englisch melden oder lieber erst mal auf Deutsch diskutieren und eingrenzen. Beachten Sie hierzu folgende Einstiegspunkte bzw. Berichts- und Diskussionsmöglichkeiten:

Grundsätzliches Vorgehen
Folgende Punkte müssen im Prinzip durchlaufen werden, damit ein Programmfehler ("Bug") behoben ("fixed") werden kann.

Klären: Ist das Problem überhaupt ein Fehler (Bug)?

 * Diskussion in user-Mailingliste Local Mailing Lists/de

Klären - nur unter Linux: Ist es ggf. ein distributionsspezifischer Fehler?

 * Tritt der Fehler nur in einer Distributionsversion oder auch in einer Vanilla-Installation auf?

Klären: Wurde der Fehler bereits gemeldet?

 * Bekannte Fehler sollten nicht erneut berichtet werden, sondern die bereits vorhandene Bugmeldung sollte bestätigt, ergänzt und/oder verbessert werden.
 * Suche nach exisitierenden Bugmeldungen in bugzilla (englisch) Link

Bestandteile des Fehlerberichts
Falls der Fehler noch nicht berichtet worden ist und nicht distributionsspezifisch ist, sollten folgende Punkte beachtet werden:

Grundsatz: Je Problem ein separater Bericht

 * Für jeden Fehler ist ein separater Bericht erforderlich, da jeder Fehler separat behandelt (behoben) werden muss.

Notwendige Angaben zum Problem:

 * Zusammenfassung: 1-Zeilige stichwortartige, aussagekräftige Beschreibung des Problems
 * Schritt für Schritt-Anleitung: Zur exakten Nachvollziehbarkeit sollte beschrieben werden:
 * die Ausgangssituation, sowie ab da
 * jeder Tastendruck oder Mausklick, jeweils mit
 * erwartetem und
 * beobachtetem Verhalten des Programms (sofern es vom erwarteten abweicht)
 * Beispieldokumente sollten, wenn sie das Problemverständnis verbessern, angehängt werden
 * Betriebssystem (Version, Sprache, gegebenenfalls Distribution, Desktop, Fenstermanager)
 * genaue LibreOffice-Version (Einfach aus Hilfe -> Info Über LibreOffice kopieren, beispielsweise "LibreOffice 3.5.1.2 Build-ID: dc9775d-05ecbee-0851ad3-1586698-727bf66")
 * gewählte Sprache der Benutzeroberfläche und Gebietsschema, sofern abweichend von "Deutsch"

Fehlersuche speziell (Linux)

 * Wie man ein Strace log, Backtrace und/oder Valgrind unter Linux einsetzt bzw. erhält Link