Si vous lisez ce document, c'est que vous souhaitez contribuer à un des projets de l'organisation. Nous vous remercions d'avance pour votre aide ! Que ce soit pour tester, corriger des bugs, ou documenter un projet, nous avons grand besoin de votre contribution !
Merci de lire le document suivant, qui vous donnera les procédures à suivre avant de soumettre une issue ou pull request. Procéder en suivant ces rêgles nous permettra de traiter plus rapidement et efficacement votre contribution.
Veuillez utiliser le systeme d'issue de Github pour signaler des bugs, ou demander des nouvelles fonctionnalités.
Avant d'ouvrir une issue, veuillez vérifier qu'une issue similaire n'existe pas déjà, ou n'a pas été récemment fermée. Dans le cas d'un bug, essayez d'inclure le plus d'informations possibles, telles que :
- Une série d'étape permettant de reproduire le bug
- La version du code utilisée
- Les modifications que vous avez fait au code qui pourraient être liées au bug
- Des particularités de votre environnement de travail
Les contributions au code peuvent être faites grace au système de pull requests de Github. Avant d'ouvrir une pull request vérifiez que :
- Vous travaillez sur la derniere version de la branche master
- Vous avez vérifier les pull requests ouvertes et récemment fermées, pour être sur que personne ne s'est encore occupé du problème.
- Vous avez ouvert une issue pour discuter des changements à faire
Pour ouvrir une pull request, veuillez :
- Forker le repertoire du projet concerné
- Modifier la source. Merci de vous concentrer sur la partie concernée par le changement. Si vous reformatez tout le code, notre travail de vérification sera plus difficile.
- Vérifiez le cas échéant que les tests passent.
- Rédigez des messages de commit propres
- Envoyez nous une pull request, en donnant des détails sur les changements faits
Github donne plus d'indications sur les forks et sur les pull requests
Regarder les issues ouvertes est un bon moyen de trouver des idées de contribution. En particulier, les issues portant le tag 'help wanted' sont un bon point de départ.
Les projets sont touhours accompagnés d'un fichier LICENSE. Veuillez noter que le code que vous contriburez sera soumis à cette licence.
Ce guide est très lourdement inspiré du guide du projet lambda-go-samples, disponible ici. La principale modification faite a été de traduire le guide en francais. Quelques adaptations ont aussi été faite pour mieux adhérer à l'organisation. Ce guide (comme celui dont il est inspiré) est placé sous la licence Creative Commons Attribution-ShareAlike 4.0 International Public License.