Wie man einen Bug meldet

This page is a translated version of the page How to report a bug and the translation is 100% complete.

Phabricator ist für Software-Fehlerberichte, Funktionsanfragen und Planungsarbeiten gedacht.

Um technische Fragen zu Wikimedia-Projekten zu stellen, siehe m:Tech
Um technische Fragen zu MediaWiki in Nicht-WMF-Installationen zu stellen, siehe Projekt:Support desk

Diese Richtlinien erklären, wie man einen guten Fehlerbericht oder Feature-Wunsch in Wikimedias Fehlerdatenbank erstellt (siehe Phabricator für weitere Informationen). Gut formulierte Fehlerberichte werden mit größerer Wahrscheinlichkeit bearbeitet als schlecht formulierte. Bug-Reports müssen in Englisch erstellt werden. Wenn du kein Englisch kannst, versuche ein Übersetzungstool wie Google Translate zu verwenden.

Kurzempfehlungen für Fehlerberichte

Sei genau!
Sei deutlich: Erkläre 1) wie man die Situation reproduzieren kann, Schritt für Schritt, ohne Raum für Interpretationen zu lassen, 2) erwartetes Verhalten, 3) tatsächliches Verhalten
Erfasse nur ein Problem oder spezifische Funktionsanfrage pro Aufgabe
Führe alle relevanten Links und Beispiele auf.

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. Wenn der Bug auf einer Wiki-Seite wie Wikipedia ist, kannst du versuchen, die neueste Softwareversion auf test2.wikipedia.org zu nutzen.

Hat schon jemand anderes das Problem gemeldet?

Verwende das Suchfeld auf Wikimedias Bugtracker, um zu sehen, ob der Fehler bereits gemeldet wurde. Du kannst auch eine erweiterte Suche durchführen auf der erweiterten Suchseite.

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.

Ist es vielleicht ein Problem mit einem Gadget / Benutzerskript?

Manche Probleme entstehen durch die Verwendung von Benutzerskripten und Gadgets, deren Fehler behoben werden müssen. Es gibt eine Anleitung , welche das Auffinden solchen Quelltexte Schritt für Schritt erklärt. Du kannst diese Anleitung nutzen, um den Fehler selbst zu beheben und Dir den Meldeaufwand zu sparen.

Ist es ein Caching-Problem?

Manche Probleme hängen damit zusammen, dass älteres, zwischengespeichertes HTML zusammen mit neuerem JavaScript ausgeliefert wird, obwohl die beiden nicht kompatibel sind. Um herauszufinden, ob dies die Ursache ist, ist es hilfreich, die Seite zu bereinigen, die Seite zu aktualisieren und zu sehen, ob das Problem weiterhin besteht.

Einen neuen Bug oder Feature-Wunsch melden

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

Gehe zu phabricator.wikimedia.org.
Du musst Dich einloggen (oder registrieren), wenn Du dies noch nicht getan hast (siehe hierzu: „Creating your account “).
Klicke auf den Lesezeichen-Knopf in der oberen rechten Ecke und wähle "Softwarefehler melden" (oder "Sicherheitsproblem melden", um ein Sicherheitsproblem zu melden )
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 gender is not functional on Special:Preferences"
  - Schlecht: "Software crashes"
- Beschreibung: Vollständige Beschreibung des Problems, in der alle aktuell zur Verfügung stehenden Informationen angegeben sind. Wenn dies nicht ausreicht, wirst Du um zusätzliche Informationen gebeten, zusammen mit einer Anleitung, wie du diese erhalten kannst. Dieses Feld sollte enthalten:
  - Für Fehler (Bugs):
    - „Schritte zur Nachverfolgung“ (Steps to reproduce): Kurz und prägnant gelistete Schritte, mit denen das beschriebene Problem einfach nachvollzogen werden kann. Bitte etwaige Sondereinstellungen nicht vergessen.
      Beispiel:
      Go to https://en.wikipedia.org with Internet Explorer version 10.0;
      
      Make sure you are logged in;
      
      Select "My Preferences" menu;
      
      Go to "Gender" and select female gender from box list;
      
      Click "Save" button.
    - „Tatsächliche Ergebnisse“ (Actual results): Was geschieht in der Applikation, nachdem die obigen Schritte ausgeführt worden sind.
      Beispiel:
      "There is no female gender in front of my username."
    - „Erwartetes Ergebnis“ (Expected results): Was hätte die Applikation korrekterweise tun sollen, wenn sie keine Fehler enthalten würde.
      Beispiel:
      "My gender is shown in front of my username."
  - 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:
      "As a new editor, I would like to be acknowledged for my contribution to the project, so that I feel welcomed and valued"
  - Bitte ergänze auch weitere Informationen, die hilfreich sein könnten, wie zum Beispiel:
    - Browser, Skins oder Betriebssysteme, auf denen der Fehler ebenfalls von Dir gefunden wurde.
    - Verweise (Links) oder Unterschiede (diffs) zu einer oder mehreren Seiten, auf denen der Fehler aufgetreten 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.
- Wähle die tags (Projekt(e)) aus, in dem Du den Fehler gefunden hast:
  - Als Projekte werden Aufgaben bezeichnet, an denen Entwickler arbeiten können. Um die richtigen Projekte zu finden, verwende die Suchfunktion (oben rechts), um zur Projektbeschreibung zu gelangen.
  - Das könnte beispielsweise MediaWiki-General für die Wiki-Software selbst oder Wikimedia-Site-Requests für Konfigurationseinstellungen der Wikimedia-Wiki-Seiten sein (siehe Selecting projects ).
- Abonnenten: Wenn du bestimmte Benutzer kennst, die daran interessiert sind, über diese Aufgabe in Kenntnis gesetzt zu werden, kannst du sie hier hinzufügen. Ignoriere andernfalls dieses Feld.

Überprüfe nochmal, ob Dein Bericht vollständig ist, und sende ihn durch einen Klick auf „Create Task“ („Aufgabe erstellen“) ab. Der Fehlerbericht landet nun in der Datenbank. Dies ermöglicht anderen, an Deinem Bericht interessierten Benutzern, diesen anzusehen und möglicherweise auch daran zu arbeiten .

Die Priorität der Bearbeitung dieser Aufgabe wird von den Entwicklern bei der Bearbeitungsplanung festgelegt, (siehe Setting priorities – Prioritäten setzen ).

Das wäre alles! Danke für deinen Einsatz, um MediaWiki und Wikimedia-Projekte zu verbessern!

Einen JavaScript-Fehler melden

Siehe auch: Hilfe:Auffinden defekter Skripte

Viele Funktionen, wie Gadgets, Benutzerskripte und einige Teile von MediaWiki, basieren auf JavaScript.

Wenn Du auf einen Fehler stößt, der möglicherweise mit JavaScript zusammenhängt, versuche Fehlermeldungen zu identifizieren und kopiere diese in den Fehlerbericht.

Es ist besonders wichtig, alle Informationen mitzuliefern, die Du hast, denn selbst die Systemadministratoren haben keinen Zugriff auf jegliches Fehler-Logbuch.

Wenn das Problem im Code eines Benutzerscripts oder Geräts liegt, ist Phabricator wahrscheinlich nicht geeignet, um das Problem zu lösen.^[1] Man wird Dich eventuell auf die Diskussionsseite des Scripts umleiten, wenn das problematische Script identifiziert werden kann.

Einen Verbindungsfehler melden

Wenn Du Schwierigkeiten hast, eine Wikimedia-Website zu erreichen (langsame Internetverbindung usw.), gehe zu wikitech:Reporting a connectivity issue (Melden eines Verbindungsproblems).

Meldung eines Login-Problems

Wenn Du Probleme hast, Dich in Dein Konto einzuloggen, folge den Anweisungen im Handbuch: Manual:How to debug/Login problems .

Anmerkungen

↑ phab:T85433 Using Phabricator for gadget-related tasks

Siehe auch

[1] :T85433 Using Phabricator for gadget-related tasks

[1]