Einen Fehler als Community-Mitglied melden
Eine gute Fehlerbeschreibung ist einer der wertvollsten Beiträge überhaupt: Sie macht aus dem Problem einer Person eine Korrektur für alle. Diese Seite ist die Sicht des Community-Mitglieds; die vollständige Anleitung steht unter Wenn etwas schiefgeht.
Inhalt
- Ist es ein Fehler?
- Der richtige Tracker
- Die Teile einer guten Fehlerbeschreibung
- Was nie in ein Issue gehört
- Nach der Meldung
Ist es ein Fehler?
| Es ist so | Dann |
|---|---|
| Die Software macht etwas falsch, und Sie können es erneut auslösen | Ein Fehler: melden Sie ihn |
| Sie wissen nicht, wie etwas geht | Eine Frage: stellen Sie sie in den Foren (Eine gute Frage stellen) |
| Jemand könnte sehen oder ändern, was er nicht sehen oder ändern sollte | Ein Sicherheitsproblem: vertraulich an [email protected] (SECURITY.md) |
| Eine Idee für das Projekt, die Website oder die Community | Der Issue-Tracker der Community |
| Es funktioniert wie vorgesehen, aber nicht so, wie Sie es möchten | Vielleicht eine negative Funktion: ein gewolltes Verhalten, kein Fehler. Lesen Sie Negative Funktionen, bevor Sie es melden |
Warnung: Manches Verhalten, das falsch aussieht, ist Absicht oder auslegungsfähig. Eine Änderung an einer solchen negativen Funktion kann jede Website betreffen, die davon abhängt; ein Issue oder Pull Request dazu braucht daher eine klare Begründung und kann mehrere Review-Runden durchlaufen, bevor er angenommen wird. Siehe Negative Funktionen.
Der richtige Tracker
| Tracker | Für |
|---|---|
| se7enxweb/exponential | Den Kernel, die Administration, die mitgelieferten Erweiterungen, die Dokumentation |
| se7enxweb/exponential-velocity | Den Anwendungsserver Velocity |
| Das eigene Repository der Erweiterung | Eine Erweiterung mit eigenem Repository; die Seite Fehler melden listet sie auf |
| se7enxweb/exponential-community | Das Projekt, die Website, das Ökosystem, alles, was kein Softwarefehler ist |
Quelle: Wenn etwas schiefgeht. Mehr zur Auswahl: Welcher Tracker für welche Meldung.
Die Teile einer guten Fehlerbeschreibung
- Ein Titel, der das Problem benennt, nicht „Es funktioniert nicht“.
- Die Schritte, nummeriert, von einem bekannten Ausgangspunkt aus.
- Erwartetes und tatsächliches Ergebnis, mit der genauen Meldung.
- Die Umgebung: Version, PHP-Version, Engine (Velocity, Apache oder nginx mit PHP-FPM, FrankenPHP), Datenbank,
Design. Setup > Systeminformationen > Bericht als Text kopieren oder
./console exp:info --plain --no-logoliefern eine Zusammenfassung ohne Passwörter, Schlüssel und Serverpfade. - Logzeilen aus dem betreffenden Zeitraum, bereinigt um alles Private.
- Ein Bildschirmfoto, wenn es hilft, ohne sichtbare private Daten.
Was nie in ein Issue gehört
Passwörter, Schlüssel, Session-Cookies, Datenbankadressen oder die personenbezogenen Daten von Kunden oder Nutzern (Wenn etwas schiefgeht).
Nach der Meldung
- Beantworten Sie Fragen der Maintainer; ein Issue, das sich nicht nachstellen lässt, wird oft geschlossen.
- Wenn Sie einen Workaround finden, ergänzen Sie ihn im Issue.
- Wenn Sie können, senden Sie die Korrektur: „Ist der Code als Git-Klone installiert, ist eine Korrektur nur einen
Branch in Ihrem Fork und einen Pull Request entfernt“ (Wenn etwas schiefgeht).
Nennen Sie das Issue (
Fixes #123) im Pull Request. - Wenn ein Release den Fehler behebt, bestätigen Sie das im Issue.
Verwandte Seiten
- Als Community-Mitglied mitwirken
- Fehler gut melden
- Testen und Fehler melden
- Probleme melden
- Freie Dokumentation: Diese Seite darf unter der GNU FDL 1.3 frei kopiert, übersetzt und verbessert werden.
Werden Sie Exponential-Partner
Partner teilen ihre Informationen, stellen Mittel bereit, geben Beiträge zurück und entwickeln die Produkte mit uns, und so wächst Exponential. Eine Partner-Website und ein Dashboard sind für Mitte 2027 geplant: Werden Sie noch heute Partner, damit wir schneller wachsen und neue Funktionen früher liefern.