Kurzempfehlungen für Fehlerberichte

• Sei genau!
• Drücke Dich klar aus: Erkläre Schritt für Schritt, wie sich das Problem reproduzieren lässt, damit andere den Fehler nachvollziehen können
• Beschreibe immer nur ein einzelnes Problem je Bericht
• Füge wichtige Links und Beispiele hinzu
• Sei deutlich: erkläre 1) wie man die Situation reproduzieren kann, schrit für schritt, ohne raum für Interpretationen zu lassen, 2) erwartetes Verhalten, 3) tatsächliches Verhalten

Erfasse nur ein Problem pro Aufgabe

• Füge alle relevanten Links und Beispiele hinzu

Bevor Du anfängst

Kannst du das Problem reproduzieren?

Versuche deinen Bug mit einer aktuellen Softwareversion zu reproduzieren, um zu prüfen, ob er schon behoben wurde.

Hat schon jemand anderes das Problem gemeldet?

Verwende das Suchfeld auf GitHubs Bugtracker, um zu sehen, ob der Fehler bereits gemeldet wurde.

Wenn du dir unsicher bist, ob ein Bug bereits gemeldet wurde, dann melde ihn trotzdem. Es ist besser, doppelt gemeldete Bugs zu haben, als überhaupt keine Meldungen.

Einen neuen Bug oder Feature-Wunsch melden

Wenn Du einen Bug in einer aktuellen Version findest, aber anscheinend niemand anderer ihn berichtet hat, dann:

1. Gehe zu https://github.com/MinersWin/Scrcpy-Desktop/issues.
2. Du musst Dich einloggen (oder registrieren), wenn Du dies noch nicht getan hast.
3. Klicke auf den grünen Button oben Rechts mit dem Titel New Issue
4. Fülle mindestens die folgenden Felder aus:
   • Titel: Eine kurze, aus einem Satz bestehende Zusammenfassung, die das Problem erklärt (aber nicht deinen Lösungsvorschlag).
     • Gut: "Selecting Template is not functional."
     • Schlecht: "Software crashes."
   • Beauftragter: Du kannst dieses Feld ignorieren. Die Entwickler werden selbst einen Beauftragten benennen, wenn sie sich um diese Aufgabe kümmern.
   • Beschreibung: Vollständige Beschreibung des Problems, so detailliert wie möglich. Diese sollte beinhalten:
     • Für Fehler (Bugs):
       • „Schritte zur Nachverfolgung“: Kurz und prägnant gelistete Schritte, mit denen das beschriebene Problem einfach nachvollzogen werden kann. Bitte etwaige Sondereinstellungen nicht vergessen.

         Beispiel (am besten in Englisch, Deutsch ist allerdings auch kein Problem):

         1. Go to https://tuning-pack.de with Internet Explorer version 10.0;
         2. Click on Download;
         3. Select the TuningPack.exe;
         4. Run it with Double Klick;
         5. Click Accept when the Info Box Pops Up.

       • „Tatsächliche Ergebnisse“: Was geschieht in der Applikation, nachdem die obigen Schritte ausgeführt worden sind.

         Beispiel:

         "Das Programm hat sich nach dem Start direkt wieder geschlossen."

       • „Erwartetes Ergebnis“: Was hätte die Applikation korrekterweise tun sollen, wenn sie keine Fehler enthalten würde.

         Beispiel:

         "DAs Programm hätte die Auswahl der Tweaks anzeigen sollen."

     • Für Feature-Anfragen:
       • Eine Beschreibung dessen, was Du erzielen möchtest und warum. Erläutere, welche Probleme die Funktion lösen soll (das eigentliche zugrunde liegende Problem), möglichst mit konkreten Beispielen. Fordere jedoch keine spezifische Lösung, da es andere / bessere Lösungen geben könnte. user story ist eine effektive Methode dies Mitzuteilen.

         Beispiel:

         "Ich hätte gerne eine Discord Integration, sodass alle meine Freunde unter meinem Namen sehen, dass ich dieses Tolle Programm benutze."

     • Bitte ergänze auch weitere Informationen, die hilfreich sein könnten, wie zum Beispiel:
       • PowerShell, .Net Framework Versionen, oder Betriebssysteme, auf denen der Fehler ebenfalls von Dir gefunden wurde.
       • Verweise (Links) oder Unterschiede (diffs) zu einem oder mehreren Screenshots, auf denen der aufgetretene Fehler zu sehen ist; oder
       • ob das Problem jedes Mal auftritt, nur gelegentlich, nur auf bestimmten Seiten oder nur unter bestimmten Umständen.
   • eine Log-Datei oder einen Screenshot anhängen (bitte achte darauf, vertrauliche Daten unkenntlich zu machen). Klicke dann auf den „Upload File“-Button (eine Wolke mit einem Pfeil) in der Toolbar des „Beschreibungs“-Feldes.

Überprüfe nochmal, ob Dein Bericht vollständig ist und sende ihn durch einen Klick auf „Submit new Issue“ („Bericht senden“) ab. Der Fehlerbericht landet nun auf der Fehlerseite. Dies ermöglicht anderen, an Deinem Bericht interessierten Benutzern, diese anzusehen und möglicherweise auch daran zu arbeiten.

Die Priorität der Bearbeitung dieser Aufgabe wird von den Entwicklern bei der Bearbeitungsplanung festgelegt.

Das wäre alles! Danke für deinen Einsatz, um die TheGeekFreaks Projekte zu verbessern!