Comment faire sa première contribution open source

Choisir un projet à ta portée

Le bon premier projet n’est pas le plus célèbre, c’est celui où tu te sentiras accueilli. Quelques signes qui ne trompent pas :

• Il est actif : des changements récents, des issues et des pull requests qui reçoivent une réponse.
• Il explique comment contribuer : un fichier CONTRIBUTING.md ou une section dédiée dans le README.
• Il est de taille raisonnable : un petit projet se lit plus vite et les mainteneurs ont plus de temps pour toi.
• Tu l’utilises ou tu le comprends : tu sauras plus facilement ce qui manque.

Sur Repolink, le filtre « Petits projets » de la recherche met en avant des créateurs moins connus, souvent très heureux d’avoir de l’aide.

Trouver une issue pour débuter

Une issue est une tâche ou un problème signalé sur le projet. Les mainteneurs marquent les plus accessibles avec le label good first issue. Tu peux les parcourir sur la page Good first issues, par langage si tu préfères.

Avant de te lancer, vérifie que personne n’est déjà dessus, puis écris un commentaire court : « Je voudrais m’en occuper, est-ce toujours disponible ? ». Attends la réponse du mainteneur : ça évite de travailler pour rien.

Faire ta copie du projet

Tu n’as pas le droit de modifier directement le dépôt d’un autre. Tu en fais donc une copie à ton nom, un fork, avec le bouton « Fork » en haut de la page du projet. Puis tu la télécharges sur ton ordinateur, c’est le clone :

git clone https://github.com/TON-PSEUDO/le-projet.git
cd le-projet

Créer une branche et faire ta modification

Travaille toujours sur une branche à part : le travail de la branche principale reste intact et ta contribution est facile à relire. Donne-lui un nom qui dit ce qu’elle fait.

git switch -c fix/faute-dans-le-readme

Fais ta modification, en restant strictement dans ce que demande l’issue : un petit changement bien fait est accepté plus vite qu’un gros. Relis les règles du projet, par exemple le format des messages de commit. Puis enregistre et envoie ton travail :

git add .
git commit -m "docs: Corrige une faute dans le README"
git push origin fix/faute-dans-le-readme

Ouvrir ta pull request

Sur GitHub, un bandeau te propose « Compare & pull request » : c’est la demande de fusion de ta branche dans le projet. Rédige-la comme tu aimerais la lire :

• un titre précis, par exemple « Corrige une faute dans le README » ;
• quelques lignes qui expliquent ce que tu as changé et pourquoi ;
• la mention Closes #12 (avec le numéro de l’issue) : GitHub fermera l’issue quand ta pull request sera acceptée.

Et après ?

Un mainteneur relira ton travail et te demandera peut-être des changements : c’est normal et ça ne veut pas dire que c’est raté. Réponds poliment, corrige sur la même branche, et ta pull request se met à jour toute seule. Selon le projet, la réponse peut prendre quelques heures ou plusieurs semaines : sois patient et ne relance pas tous les jours.

Quand ta pull request est fusionnée, tu es officiellement contributeur. Tu peux alors choisir une deuxième issue, un peu plus ambitieuse : la première marche est franchie.