Mitwirken
Vielen Dank für Ihr Interesse an Duckling!
Überblick
In diesem Abschnitt finden Sie alles, was Sie für eine effektive Mitarbeit wissen müssen.
-
Entwicklungsumgebung
Entwicklungsumgebung einrichten
-
Code-Stil
Kodierungsstandards und Konventionen
-
Tests
Tests schreiben und ausführen
-
:material-accessible:{ .lg .middle } Barrierefreiheit
UI-Semantik, Fokus und Prüfungen in der Dokumentation
-
Verhaltenskodex
Gemeinschaftsrichtlinien und Standards
Verhaltenskodex
Durch Ihre Teilnahme an diesem Projekt erklären Sie sich mit unserem Verhaltenskodex einverstanden, der auf dem Contributor Covenant 3.0 basiert. Wir verpflichten uns zu einer einladenden und inklusiven Umgebung für alle.
Wie Sie mitwirken können
Fehler melden
- Vorhandene Issues prüfen, um Duplikate zu vermeiden
- Neues Issue anlegen mit:
- Klarer, beschreibender Titel
- Schritten zur Reproduktion
- Erwartetem vs. tatsächlichem Verhalten
- Umgebungsdetails (Betriebssystem, Browser, Versionen)
- Screenshots falls zutreffend
Funktionen vorschlagen
- Vorhandene Issues auf ähnliche Vorschläge prüfen
- Feature-Request anlegen mit:
- Klarer Beschreibung der Funktion
- Anwendungsfall und Nutzen
- Möglichem Implementierungsansatz
Pull Requests
- Repository forken
- Feature-Branch anlegen:
git checkout -b feature/ihr-feature-name - Änderungen vornehmen
- Tests schreiben/aktualisieren
- Tests ausführen: Alle Tests müssen bestehen
- Klare Commit-Nachrichten: Konventionelle Commits (siehe Code-Stil)
- Alle Commits mit DCO signieren: Jeder Commit MUSS eine Zeile
Signed-off-by:enthalten (siehe Code-Stil) - In Ihren Fork pushen
- Pull Request erstellen
Review-Prozess
- Alle PRs benötigen mindestens eine Genehmigung
- CI-Prüfungen müssen bestehen
- Die Code-Abdeckung sollte nicht sinken
- Die Dokumentation muss bei Bedarf aktualisiert werden
Anerkennung
Mitwirkende werden erwähnt in:
- CHANGELOG.md bei bedeutenden Beiträgen
- README.md im Abschnitt zu Mitwirkenden
Vielen Dank für Ihren Beitrag zu Duckling!