Comment contribuer à un projet open source sur GitHub ?
June 27, 2022
1 - Faire un Fork du projet en question 🍴
Vous avez forcément déjà vu ce bouton en parcourant un projet sur GitHub
Commencez donc par cliquer sur Fork depuis le projet auquel vous voulez contribuer
Vous serez ensuite redirigé vers cette page, qui vous invitera si vous le souhaiter à renommer le projet et à changer sa description avant de le forker (c’est à dire en faire une copie) dans votre GitHub
Cliquez sur Create fork
Vous allez maintenant être redirigé vers votre version du projet, pour bien faire la différence avec le projet original, il vous suffit de vérifier si c’est bien votre username qui apparait en haut à gauche !
2 - Appliquez vos changements :
Cette étape dépend de vous, maintenant tout est possible, vous pouvez :
- Juste faire une update depuis GitHub, sur le fichier README.md par exemple
- Cloner le repositoy en local comme si c’était le votre (c’est le votre) et push vos changement comme à votre habitude
Veillez à bien soigner vos messages de commit, si vous voulez avoir plus de chance que vos changements soient validés il vaut mieux qu’ils soient clair pour la personne qui va en décider !
3 - Effectuer une Pull Request 🙏
Une fois que vos commits sont bien push sur votre version du projet il va falloir faire une pull request
Normalement vous allez voir un message de ce genre s’afficher en haut de votre copie du repository
Cliquez sur contribute
Puis cliquez sur Open pull request
Vérifiez une dernière fois vos changement puis cliquez sur Create pull request
Ecrivez un message et une description résumant tous vos changements puis cliquez à nouveau
Si il ne s’agit que d’un seul commit, vous pouvez laisser le message de commit
Et voilà … !
Plus qu’a attendre que l’une des personnes en charge du projet principale accepte votre contribution, vous pourrez communiquer sur d’éventuels changements à faire avant que votre proposition soit mergée sur la page de la pull request
