Nous sommes ravis que vous envisagiez de contribuer à notre projet ! Chaque contribution est importante et très appréciée.
Vous pouvez contribuer de plusieurs manières :
Si vous trouvez un bug, merci de le signaler en créant une "issue". Veuillez fournir autant de détails que possible pour que nous puissions comprendre et reproduire le problème. Ceci inclut :
- Une description claire et concise du bug.
- Des étapes pour reproduire le bug.
- La version du logiciel utilisée.
- Des captures d'écran ou des logs, si applicable.
Si vous avez des suggestions pour améliorer le logiciel, n'hésitez pas à ouvrir une "issue" pour en discuter. Cela pourrait inclure de nouvelles fonctionnalités, des modifications des fonctionnalités existantes ou des améliorations de la documentation.
Vous pouvez aussi soumettre directement vos modifications par une "pull request" (PR). Voici comment procéder :
- Fork le projet sur GitHub.
- Clonez votre fork sur votre machine locale.
- Créez une nouvelle branche pour vos modifications.
- Effectuez vos modifications.
- Committez vos changements avec des messages de commit explicatifs.
- Poussez votre branche sur votre fork.
- Ouvrez une pull request de votre branche vers la branche principale du projet original.
- Décrivez en détail les modifications proposées et toute autre information pertinente.
Nous attendons de tous les contributeurs qu'ils adhèrent à notre Code de Conduite. En participant à ce projet, vous acceptez de respecter ses termes.
Pour configurer l'environnement de développement sur votre machine locale, suivez les étapes suivantes :
-
Installez toutes les dépendances nécessaires :
pip install -r requirements.txt
-
Configurez les variables d'environnement nécessaires.
-
Lancez l'application en mode développement pour vérifier que tout fonctionne correctement.
Avant de soumettre une pull request, assurez-vous que votre code passe tous les tests existants et, si vous ajoutez de nouvelles fonctionnalités, ajoutez également des tests appropriés. Cela garantit que le code introduit ne casse pas les fonctionnalités existantes et répond aux critères de qualité du projet.
Si vous avez des questions ou avez besoin d'aide pour configurer votre environnement de développement, n'hésitez pas à demander de l'aide via les "issues".
Nous tenons à remercier tous ceux qui contribuent à ce projet, que ce soit par des suggestions, des contributions directes au code ou par des discussions utiles.
Merci d'avoir choisi de contribuer à notre projet. Votre aide est essentielle pour le faire grandir et s'améliorer.