👨💻 Pourquoi contribuer ?
Que des avantages, il faut juste sortir de sa zone de confort pour :
- Améliorer tes compétences
- Rencontrer des gens comme toi
- Faire avancer un projet
- Résoudre des bugs et faire plaisir à des gens
Et surtout, ne pas avoir peur, jamais tu ne te feras moquer ou rabaisser si tu contribues à un projet, la communauté est accueillante et bienveillante ✌️.
❓ Comment commencer ?
La grande majorité des projets open source sont sur GitHub, dans un premier temps, tu peux réaliser des petites contributions techniques, corriger / améliorer la documentation du projet ou même faire de l'UI.
Pour tout ce qui est technique, il faut se référer aux issues du projet, si quelqu'un a remonté un bug que tu penses pouvoir résoudre, let's go !
Si tu veux coder une fonctionnalité, le mieux avant de la faire est de créer une issue en demandant si la fonctionnalité que tu as en tête est bien dans l'esprit du projet et une fois le feu vert, tu peux la réaliser 💪.
👉 N'oublie pas de bien regarder les issues et les Pull requests en cours avant de te lancer dans une réalisation.
🗄️ Les fichiers importants
Dans l'univers de l'open source, tu vas souvent retrouver ces différents fichiers :
- LICENSE : Un projet n'est pas open source s'il n'a pas de licence
- README : Fichier qui présente le projet, mais qui peut aussi donner des informations sur la contribution
- CONTRIBUTING : Fichier spécifique à la contribution
- CODE_OF_CONDUCT : Code de conduite du projet, à respecter pour un environnement sain
👉 Si tu veux un exemple, Symfony est un projet open source qui contient ces quatre fichiers.
Proposer une contribution
Pour proposer une contribution, plusieurs étapes sont nécessaires (non exhaustif et pas forcément dans le bon ordre) :
- Communiquer, dans le respect, de façon efficace et bienveillante
- Fork le repository
- Clone le localement
- Mets-le à jour régulièrement
- Crée une branche
- Bien tester tes changements
- Push ton code
- Ouvre une Pull request (PR) sur le repository parent
👉 Le nom de la branche, du commit et la description de ta PR, dépend du projet et de ce qu'il y a marqué dans le README ou dans le CONTRIBUTING.
🙂 Et après ?
Plusieurs possibilités :
😐 Pas de réponses
Cela arrive, surtout si le projet est mort ou laissé un peu de côté, si cela fait un petit moment, n'hésite pas à tag des mainteneurs du projet et/ou de up, c'est-à-dire de mettre un message dans le fil de discussion de ta PR.
📦 Des modifications sont attendues
C'est assez courant, si vous ne savez pas pourquoi ou comment faire les modifications, n'hésite pas à demander de l'aide, rappelle-toi que la communication est cruciale dans l'open source 👍.
Si tu n'as pas le temps de faire les corrections, préviens-les, pour que quelqu'un d'autre prenne le relais.
👎 Non acceptée
Pour éviter que cela arrive, il est fortement recommandé de demander en amont du développement, si la fonctionnalité est "mergeable".
Si tu ne comprends pas la décision, tu peux continuer à maintenir ta version du projet, avec ton fork, de ton côté 😉.
👍 Acceptée
Te voilà contributeur d'un projet open source, c'est la classe non ? 😎