Teilen ist wichtig: So schreiben Sie einen effektiven Fehlerbericht

Zuletzt aktualisiert am 08. März 2021 – Jonny Steiner, Produktmarketingmanager

Jeder kann einen anständigen Fehlerbericht schreiben. Nachdem Sie diesen hilfreichen Blog gelesen haben, werden Sie in der Lage sein, einen wirklich effektiven zu schreiben.

Manchmal, wenn ich durch mein Telefon scrolle, merke ich, wie viele der Apps, die ich verwende, kostenlos sind. Nun ja … kostenlos für mich, aber nicht kostenlos zum Erstellen. Jede dieser Apps wurde mir kostenlos zur Verfügung gestellt, nachdem ich Tausende von Stunden damit verbracht hatte, die App zu entwickeln, zu testen, Fehlerberichte zu schreiben und sie zu debuggen.

Wir reden viel über die Entwicklungs- und Testseite des SDLC, aber was ist mit der fehlerhaften Seite? Während des App-Entwicklungsprozesses können Fehler auftreten – das ist normal und wird erwartet. Die Frage ist, wie Sie diese Fehler an die Entwicklungsteams weitergeben. Jeder kann einen anständigen Fehlerbericht schreiben – nicht viele Leute können einen wirklich effektiven schreiben.

Kommunikation ist hier wie immer ein wichtiger Faktor. Wer einen Fehler entdeckt, muss die Details und Erkenntnisse einfach und effektiv kommunizieren.

Wie schreibt man also einen tollen Fehlerbericht? Lassen Sie es uns gemeinsam aufschlüsseln.

Aber zuerst: Was ist überhaupt ein Fehler?

Es besteht kein Zweifel, dass Sie auf eines gestoßen sind. Jeder hat … es sei denn, er hat noch nie einen Computer oder ein Smartphone benutzt. Möglich, aber heutzutage immer unwahrscheinlicher.

Eine Definition besagt, dass ein Bug eine Art Fehler oder Fehler in einer Web- oder mobilen App ist, der unbeabsichtigtes oder falsches Verhalten verursacht.

Bugs sind sowohl aus Nutzersicht als auch aus Entwicklersicht ein Ärgernis. Sie können Moll oder Dur sein. Ein Fehler könnte einen leichten Datenfehler verursachen. Ein anderer könnte Ihr gesamtes System zum Absturz bringen.

In jedem Fall müssen Fehler gemeldet werden, wenn sie entdeckt werden. Dies betrifft nicht nur die Entwicklerseite – auch Benutzer haben die Möglichkeit, Fehler zu melden, und ihre Erkenntnisse tragen dazu bei, eine Software oder App besser zu machen.

Schauen wir uns also einige Möglichkeiten an, wie Sie Ihre Fehlerberichte besser und damit effektiver gestalten können. Das Ergebnis sollte sein, dass der betreffende Fehler behoben ist.

Die Kennzeichen eines effektiven Fehlerberichts

Das sind die Grundlagen. Wir werden etwas weiter unten im Artikel mit dem Verfassen eines Berichts beginnen, aber stellen Sie vorerst sicher, dass Sie:

  • Fehler richtig nummerieren — Ihre Fehlerberichte benötigen eine leicht identifizierbare Nummerierungsreihenfolge. Es hilft, jeden Fehlerdatensatz zu identifizieren. Wenn Sie über ein Berichtstool verfügen, nummeriert das Tool den Fehlerbericht jedes Mal automatisch.
  • Fehler reproduzieren — Fügen Sie immer die Schritte hinzu, die zur Reproduktion des Fehlers erforderlich sind. Machen Sie daraus eine Schritt-für-Schritt-Anleitung und lassen Sie keinen Schritt aus, egal wie irrelevant er auch erscheint. Wenn Sie einen Fehler nicht reproduzieren können, können Sie ihn auch nicht beheben.
  • Geben Sie Einzelheiten an — Fehlerberichte müssen nicht in blumiger Handschrift verfasst sein. Kommunizieren Sie effektiv mit möglichst wenigen Worten. Kombinieren Sie auch keine Fehler, egal wie ähnlich sie sind. Jeder Fehler erhält einen eigenen Bericht.

Wie schreibe ich einen guten Fehlerbericht?

Wir werden uns gleich mit den Einzelheiten einer Fehlerberichtsvorlage befassen, aber bevor wir damit beginnen, werfen wir einen genaueren Blick auf einige wichtige Tipps, die Ihnen beim Verfassen eines besseren Fehlerberichts helfen werden:

  1. Melden Sie Fehler sofort — Wenn Sie beim Testen einen Fehler entdecken, zögern Sie nicht; Bereiten Sie gleich Ihren Bericht vor. Wenn Sie das Schreiben Ihrer Berichte verschieben, besteht die Möglichkeit, dass Sie einige Schritte im Prozess verpassen und der Fehler nicht reproduziert werden kann.
  2. Fehler mehrfach reproduzieren — Der beste Weg, um sicherzustellen, dass ein Fehler behoben wird, ist eine Schritt-für-Schritt-Anleitung zur Reproduktion. Wir haben auch unzählige Fälle erlebt, in denen sich ein Fehler, der nicht reproduziert werden konnte, als Umgebungs- oder Benutzerfehler herausstellte.
  3. Testen Sie ähnliche Module — Entwickler verwenden unterschiedliche Codes, um Module zu trennen, sogar ähnliche. Es besteht die Möglichkeit, dass Ihr Fehler an anderer Stelle aufgetreten ist, daher lohnt es sich, ihn zu untersuchen.
  4. Eine Zusammenfassung schreiben — Eine Zusammenfassung hilft, den Fehler aus der Sicht des Entwicklers zu analysieren. Wenn es schlecht vorbereitet und geschrieben ist, führt dies zu Entwicklungs- und Testverzögerungen. Kommunikation ist von entscheidender Bedeutung und Ihr Bericht wird als Referenz für die Suche im Fehlerinventar dienen.
  5. Überprüfen Sie Ihre Arbeit — Stellen Sie sicher, dass Ihre Sprache, Ihr Wortlaut und Ihre Anweisungen klar sind, damit keine Verwirrung entsteht.
  6. Nachsorge — Sobald Ihr Bericht eingereicht wurde, nehmen Sie die Nachverfolgung vor. Machen Sie den Entwicklern bereits im Bericht selbst deutlich, dass Sie bereit sind, sich zu beteiligen. Wenn Sie Ihrem Entwicklungsteam zeigen, dass es geschätzt wird, ist die Wahrscheinlichkeit, dass Ihre Fehler behoben werden, weitaus größer.

Beim Schreiben von Fehlerberichten ist es wichtig, sich darüber im Klaren zu sein, dass Sie sich mit Ihrer Zielgruppe vertraut machen müssen. Auf diese Weise können Sie Ihren Fehlerbericht so vorbereiten, dass der Testprozess für die Zielgruppe vereinfacht wird.

So schreiben Sie einen Fehlerbericht

Wie versprochen erstellen wir eine Vorlage, die Sie beim Melden von Fehlern in Ihrer Organisation verwenden können. Von oben beginnend:

  • Reporter: Ihr Name und Ihre Kontaktdaten. E-Mail reicht in der Regel aus.
  • Produkt: Welches Produkt war im Einsatz, als der Fehler entdeckt wurde?
  • Version: Die Versionsnummer des Produkts, bei dem der Fehler aufgetreten ist.
  • Komponenten: Die wichtigsten Untermodule des betreffenden Produkts.
  • Plattformen: Die Hardware, die Sie verwendet haben, als der Fehler auftrat.
  • OS: Es müssen verschiedene Versionen und Betriebssysteme angegeben werden, bei denen der Fehler aufgetreten ist. Auch jedes einzelne.
  • Priorität: Ziemlich einfach. Wählen Sie die Priorität aus, wie wichtig die Fehlerbehebung ist.
  • Severity: Mit dieser Metrik beschreiben Sie, wie schwerwiegend ein Fehler auf das System ist. Die Schweregrade reichen von trivial über geringfügige bis hin zu schwerwiegenden und kritischen Fehlern.
  • Status: Messung des Fertigstellungsgrads eines Fehlers von „neu“ bis „behoben“.
  • Beauftragter: Wenn Sie die Person kennen, die für die Behebung des Fehlers verantwortlich sein wird, weisen Sie Ihren Bericht auf jeden Fall dieser Person zu. Wenn nicht, weisen Sie es dem Manager zu und lassen Sie ihn von dort weitermachen.
  • URL: Ort, an dem der Fehler aufgetreten ist.
  • Zusammenfassung: Kurze Beschreibung des Produkts des Fehlers.
  • Beschreibung des Produkts: Längere, ausführlichere Erläuterung des Fehlers und aller seiner Facetten. Sie müssen die Schritt-für-Schritt-Beschreibung des Produkts hinzufügen, um den Fehler zu reproduzieren. Geben Sie außerdem an, wie sich die App voraussichtlich verhalten wird, sowie das tatsächliche Ergebnis.

Die Qualität Ihrer Fehlerberichte

Ein Fehlerbericht muss von höchster Qualität sein. Je besser Sie es vorbereiten, desto einfacher wird es für das Entwicklungsteam sein, gefundene Fehler zu beheben. Ein Fehlerbericht dient als wichtiges Kommunikationselement zwischen Testern, Entwicklern und Managern.

Mit dem Aufwand, den Sie in die Erstellung der bestmöglichen Fehlerberichte investieren, tragen Sie dazu bei, organisatorische Ressourcen zu sparen und die Kommunikation zwischen Testern und Entwicklern zu verbessern.

Dies ist im Jahr 2021 noch wichtiger, da Teams aus der Ferne arbeiten, Unternehmen in die Cloud wechseln und agil sind DevOps Methoden erfreuen sich zunehmender Beliebtheit. Diese Veränderungen haben die Kommunikation und damit auch die Bewertung von Web- und mobilen Apps erschwert.

Durch das Melden von Fehlern können Tester die Software verbessern – es ist eine Frage der Proaktivität. Sitzen Sie nicht herum und warten Sie darauf, dass etwas repariert wird. Indem Tester eine aktive Rolle bei der Fehlererkennung übernehmen, zeigen sie die Bereitschaft ihres Teams zur Teilnahme und verbessern das Ansehen des Testteams innerhalb der Organisation.

Wenn Sie nach einer guten Möglichkeit suchen, Fehler zu entdecken, die aufgezeichnet werden müssen, werfen Sie einen Blick auf ein aktuelles Webinar: „Barrieren abbauen: Warum das Testen in der Cloud im Jahr 2021 wichtig ist".

Auch interessant