Bug Report schreiben

Mit einem Bug Report helfen Sie dabei, Probleme in meddevo schnellstmöglich zu identifizieren und zu beheben. Folgende Schritte beschreiben, wie Sie einen Bug Report korrekt einreichen.

1. Bevor Sie einen Bug Report schicken

  1. Testen Sie, ob das Problem reproduzierbar ist. Manchmal können z.b. durch eine wackelige Internetverbindung vermeintliche Probleme entstehen, die aber nicht wirklich ein Software Fehler sind.
  2. Versuchen Sie so genau wie möglich einzugrenzen, was GENAU Sie gemacht haben, bevor der Fehler auftreten ist. Für uns ist es wichtig, das Vorgehen Schritt für Schritt nachstellen zu können, damit wir die Fehlerquelle finden können

2. Aufrufen des Bug Report-Formulars

  1. Melden Sie sich in meddevo an.
  2. Navigieren Sie oben rechts zu Ihren Initialen.
  3. Klicken Sie auf Ihre Initialen und wählen Sie "Probleme und Ideen" aus dem Dropdown-Menü.

3. Ausfüllen des Formulars "How can we help"

Im Formular stehen Ihnen verschiedene Optionen zur Auswahl. Für einen Bug Report wählen Sie:

  • I want to report a problem with meddevo

Falls Sie stattdessen einen Verbesserungsvorschlag haben, wählen Sie:

  • I have an idea or wish for a missing feature in meddevo

4. Angaben zum Environment

Wählen Sie, in welchem System das Problem aufgetreten ist

  • prod (Produktivsystem)

5. Beschreibung des Problems

Beachten Sie dabei folgenden Hinweise beim Ausfüllen des Formulars:

  • Bleiben Sie sachlich und präzise.
  • Vermeiden Sie Vermutungen; schildern Sie nur beobachtbare Fakten.
  • Je detaillierter Ihre Angaben, desto einfacher wird die Fehlersuche.
  • Fügen Sie möglichst viele Informationen an, z.B. Fehlermeldung, Uhrzeit, Screenshots etc.
  • Jeder Bug Report sollte nur ein Problem enthalten

Hier finden Sie Tipps/Beispiele für die jeweiligen Punkte:

Short Title

Der Titel erscheint im Changelog, damit Sie die Fehlerbehebung später identifizieren können. Bitte formulieren Sie ihn kurz, eindeutig und vorzugsweise auf Englisch. Vermeiden Sie es, den Titel als Frage zu formulieren.

Can you describe what you were trying to do?

Beschreiben Sie, welche Aktion Sie durchführen wollten.

Beispiel: "Ich wollte ein neues Produkt anlegen."

What did you expect to happen?

Erklären Sie, welches Ergebnis Sie erwartet haben.

Beispiel: "Ich erwartete, dass das Produkt zur Liste hinzugefügt wird."

What actually happened?

Beschreiben Sie, was tatsächlich passiert ist.

Hier kann bereits eine detaillierte Beschreibung anhand folgender Fragen gegeben werden:

  1. Wo sind Sie gerade?
  2. Was haben Sie vorher getan?
  3. Können Sie Screenshots mitgeben?
  4. Beschreib Sie genau was Sie machen wollten.

Beispiel: "Statt ein Produkt anzulegen, lädt das System sehr lange und gibt irgendwann die Fehlermeldung “FehlerXYZ”"

Is there a particular step where the issue arises? How could we get to this error, so that we can fix it?

Listen Sie die letzten Schritte vor dem Fehler auf. Geben Sie eine Schritt-für-Schritt-Anleitung, um das Problem zu reproduzieren, und geben Sie immer an, wo genau Sie sich in der Software befinden. Die Reproduktionsschritte sind entscheidend, damit wir die Ursache des Problems identifizieren können. Bewertungen oder Erklärungen sind an dieser Stelle nicht notwendig; listen Sie aus Nutzersicht einfach jede einzelne Aktion bis zum Auftreten des Fehlers auf. Klare und detaillierte Angaben der Schritte sind vermutlich der wichtigste Faktor für eine schnelle Problemlösung.

Beispiel:

  1. Gehe in die Sammlung “Produkte”
  2. "Neues Produkt anlegen" klicken
  3. Alle Pflichtfelder ausfüllen
  4. "Speichern" klicken
  5. Fehlermeldung erscheint

Where would you go with this issue if it was a real-life medical problem?

Mit dieser Frage möchte das Formular einschätzen, wie kritisch Ihr gemeldetes Problem ist. Stellen Sie sich vor, das technische Problem wäre eine körperliche Beschwerde. Welche der folgenden Maßnahmen entspricht Ihrer Einschätzung der Dringlichkeit?

Sie können aus den folgenden Optionen wählen:

Emergency Room: Das Problem ist akut und sehr dringend. Es muss sofort behoben werden, da ansonsten schwerwiegende Folgen drohen.

Urgent Care: Das Problem ist wichtig und sollte möglichst bald gelöst werden, aber es ist kein lebensbedrohlicher Notfall. Es sollte schnell behandelt werden, um eine Verschlimmerung zu verhindern.

Doctors Appointment: Das Problem ist nicht akut, aber es sollte bei Gelegenheit untersucht und behoben werden.

Pharmacy: Das Problem ist geringfügig und könnte mit einem kleinen „Trick“ oder durch eine Anleitung selbst gelöst werden.

Drink a cup of tea and rest: Das Problem ist nicht gravierend und stört kaum. Es reicht, ruhig abzuwarten – etwa wie bei leichten Beschwerden, bei denen Sie einfach Tee trinken und sich ausruhen würden.

Bitte versuchen Sie dabei stets, wirklich ehrlich zu bewerten. Unser Team arbeitet nonstop daran meddevo zu verbessern und meistens ist unser Ideenboard voll. Natürlich werden kritische Fehler vorgezogen, das heißt aber auch dass wir in unseren geplanten Aufgaben ausgebremst werden. Wir verstehen, dass jeder Fehler ärgerlich ist - aber je mehr Unterbrechungen wir haben, desto langsamer sind wir darin meddevo weiterzuentwickeln. Deshalb ist es wichtig, das wirklich nur kritische Fehler in den oberen Kategorien landen.

Would you like to attach any screenshots or files?

Screenshots oder relevante Dateien können Sie hier anhängen; dies hilft oft bei der Fehlerbehebung. Bitte fügen Sie Anhänge immer direkt dem Ticket bei und senden Sie diese niemals per E-Mail oder Chat an eine einzelne Person. Das Versenden an eine Person kann zu Verwirrung führen und es besteht die Gefahr, dass wichtige Informationen verloren gehen, falls diese Person abwesend ist.

6. Absenden

  • Überprüfen Sie Ihre Eingaben auf Vollständigkeit.
  • Klicken Sie auf "Submit", um den Bug Report abzusenden.

Was this article helpful?