Contribuer
Merci de votre intérêt pour contribuer à Duckling !
Aperçu
Cette section couvre tout ce dont vous avez besoin pour contribuer efficacement.
-
Environnement de développement
Configurer votre environnement de développement
-
Style de code
Normes et conventions de codage
-
Tests
Rédiger et exécuter des tests
-
:material-accessible:{ .lg .middle } Accessibilité
Sémantique de l’interface, focus et vérifications de la documentation
-
Code de conduite
Lignes directrices et normes de la communauté
Code de conduite
En participant à ce projet, vous acceptez de respecter notre code de conduite, fondé sur le Contributor Covenant 3.0. Nous nous engageons à offrir un environnement accueillant et inclusif pour tous.
Comment contribuer
Signaler des bogues
- Consultez les tickets existants pour éviter les doublons
- Créez un nouveau ticket avec :
- Un titre clair et descriptif
- Les étapes pour reproduire
- Le comportement attendu vs réel
- Détails de l’environnement (OS, navigateur, versions)
- Captures d’écran si pertinent
Proposer des fonctionnalités
- Consultez les tickets existants pour des suggestions similaires
- Créez une demande de fonctionnalité avec :
- Une description claire de la fonctionnalité
- Cas d’usage et bénéfices
- Piste d’implémentation possible
Pull requests
- Forkez le dépôt
- Créez une branche de fonctionnalité :
git checkout -b feature/nom-de-votre-fonctionnalite - Apportez vos modifications
- Rédigez ou mettez à jour les tests
- Exécutez les tests : tous doivent réussir
- Messages de commit clairs : commits conventionnels (voir Style de code)
- Signez tous les commits avec le DCOÂ : chaque commit DOIT inclure une ligne
Signed-off-by:(voir Style de code) - Poussez vers votre fork
- Ouvrez une pull request
Processus de revue
- Chaque PR nécessite au moins une approbation
- Les vérifications CI doivent réussir
- La couverture de code ne doit pas diminuer
- La documentation doit être mise à jour si nécessaire
Reconnaissance
Les contributeurs seront mentionnés dans :
- CHANGELOG.md pour les contributions importantes
- La section contributeurs du README.md
Merci de contribuer à Duckling !