User:Nnino/Drafts/BugReportsBetter

From The Document Foundation Wiki
Jump to: navigation, search

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:

Erforderliches Fachwissen Englisch Deutsch
gering
  • Mailinglisten
    (zum Abklären, Diskutieren, Bestätigung einholen):
  • Deutsche Users-Mailingliste (Normalfall) Link
  • Webformular deutsch (anonym) Link
fortgeschritten
  • Bug Report Assistant
    (mittlerer Schwierigkeitsgrad, für Fortgeschrittene) Link
  • Deutsche Discuss-Mailingliste (für Entwicklerversionen) Link
Experten
  • Direkt in Bugzilla Link
  • Englische QA-Mailingliste
    (für grundsätzliche Fragen)

Grundsätzliches Vorgehen

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

Klärungsschritte

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

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