Vous souhaitez contribuer aux logiciels Open Source ? Voici comment commencer

Saviez-vous que vous pouvez contribuer à de nombreux projets open source sans être un expert de GitHub, Git ou du codage ? Que vous soyez ou non un programmeur expérimenté, vous pouvez apprendre à utiliser l'hébergeur de code source le plus populaire au monde en quelques étapes seulement.

Qu'est-ce que Git et qu'est-ce que GitHub ?

Git est le premier système de contrôle de versions au monde. Il vous permet de conserver un historique complet de tous les fichiers avec lesquels vous travaillez, permettant ainsi la collaboration et la protection de vos précieuses données. Vous pouvez afficher les fichiers à tout moment dans cet historique et utiliser les nombreuses fonctionnalités de Git pour gérer votre code source ou d'autres types de fichiers texte.

GitHub est une application Web qui utilise Git pour héberger et gérer plus de 420 millions de référentiels (dépôts), qui sont généralement des projets logiciels open source. Le site ajoute des fonctionnalités en plus de Git, notamment des suivis de bogues, la gestion des tâches et des wikis. Cependant, vous n'avez pas besoin de GitHub pour utiliser Git, et il existe de nombreuses alternatives à GitHub, notamment GitLab et Gitea. Cependant, le premier projet auquel vous souhaiterez contribuer sera très probablement sur GitHub, et c'est pourquoi nous le démontrons ici.

Commits et demandes de tirage expliqués

Lorsque vous souhaitez enregistrer vos modifications dans un fichier contrôlé par Git, vous effectuez un « commit ». Un commit peut représenter des modifications apportées à un ou plusieurs fichiers, et ces modifications peuvent être aussi grandes ou petites que vous le souhaitez. Si jamais vous en avez besoin, vous pouvez restaurer un fichier à partir de n'importe quelle validation précédente, alors considérez les validations comme des points de sauvegarde explicites pour votre projet.

Vous pouvez utiliser Git pour votre propre travail privé, mais son véritable pouvoir vient de la collaboration. Si vous travaillez sur un projet avec d'autres personnes, vous pouvez utiliser Git pour vous assurer que vos modifications n'entrent pas en conflit avec celles de vos collègues.

Lorsque vous avez modifié un projet, vous pouvez soumettre votre commit sous forme de « pull request ». Cela permet au(x) responsable(s) du projet d'examiner votre modification et, si elle est approuvée, de l'inclure dans la source officielle. Une grande partie de ce processus se déroule automatiquement, de sorte que les projets GitHub peuvent fonctionner efficacement, même avec des centaines de contributeurs apportant des modifications régulières.

Comment effectuer et soumettre une modification

Git est un excellent outil qui mérite d'être étudié, mais sa courbe d'apprentissage est assez abrupte. Heureusement, vous pouvez utiliser GitHub pour contourner ce problème et commencer à contribuer à des logiciels open source avec un minimum d'effort.

N'effectuez pas de validations de tests ou de demandes d'extraction sur des projets à moins qu'ils ne l'autorisent explicitement. Pour ce didacticiel, vous pouvez modifier le fichier README.md dans l'exemple de référentiel que nous avons créé.

Inscrivez-vous avec GitHub

Vous ne pouvez pas apporter de modifications anonymes sur GitHub, mais il est facile de vous inscrire et de commencer à utiliser le site. Vous devrez fournir une adresse e-mail et vérifier votre compte :

Une fois l'inscription terminée, vous verrez un tableau de bord personnel que vous pourrez utiliser pour explorer GitHub et en savoir plus sur le service :

Trouver un référentiel

De nombreux projets contiennent des fichiers texte simples que vous pouvez améliorer en utilisant des compétences de base en édition et en rédaction. Ces pages peuvent inclure des fichiers d'aide, du contenu Web, etc. Les projets apprécieront généralement les corrections de fautes de frappe et beaucoup ont besoin d'aide pour traduire du texte dans d'autres langues.

Certains projets sont presque entièrement constitués de texte qui sert de données pour d'autres programmes. Par exemple, tldr est un outil qui complète les pages de manuel et son contenu est géré dans un référentiel GitHub.

Le site Web d'un projet aura généralement un lien vers son référentiel GitHub. Recherchez un lien en haut à droite intitulé « Fork me on GitHub » ou un libellé tel que « Find this page on GitHub » à côté du logo « octocat » de GitHub.

Modifier un fichier

Si vous avez accédé directement à un fichier, vous pouvez ignorer cette première étape. Sinon, utilisez le navigateur de fichiers du référentiel pour localiser un fichier que vous souhaitez modifier. Cliquez sur le nom du fichier et vous devriez voir un écran qui ressemble à ceci :

Cliquez sur l'icône en forme de crayon sur le côté droit de la page. Lorsque vous essayez de modifier un fichier à partir d'un référentiel que vous ne possédez pas, GitHub vous dira que vous devez d'abord le forker :

Cela créera une copie (fork) du projet sous votre propre compte. Une fois que vous aurez effectué vos modifications, vous pourrez les soumettre aux propriétaires du projet d'origine sous forme de pull request.

Effectuez la modification à l'aide de l'éditeur basé sur le navigateur de GitHub. Il s'agit d'une zone de texte simple avec des fonctionnalités de base, notamment la coloration syntaxique. Vous ne voudrez pas l'utiliser pour des modifications importantes ou compliquées, mais c'est parfait pour un changement rapide comme une faute de frappe ou une correction de formatage.

Une fois que vous avez mis à jour le fichier, cliquez sur le bouton « Valider les modifications ». Ajoutez une « Description étendue » utile dans la zone de texte qui apparaît ensuite. Vous n'avez pas besoin d'expliquer en détail ce que vous avez modifié, mais simplement pourquoi vous l'avez fait. Pour l'instant, restez simple : « Faute de frappe corrigée » ou « Lien brisé remplacé » conviennent.

Ouvrir une demande de tirage

Cliquez sur « Proposer des modifications ». Cela devrait vous amener à une page intitulée « Comparaison des modifications » qui affiche les détails de votre mise à jour. Cliquez sur « Créer une demande de tirage ».

La page suivante demande à nouveau un titre et une description. Puisque vous apportez une seule modification à un fichier, celui-ci devrait automatiquement être renseigné avec les détails que vous avez fournis précédemment, il vous suffit donc de cliquer à nouveau sur « Créer une demande d'extraction » pour continuer.

Vous vous retrouverez sur la page des demandes d'extraction du référentiel du projet d'origine.

Que se passe-t-il ensuite ?

Le(s) responsable(s) du projet d'origine examineront votre modification. Si tout va bien et que votre modification est acceptée, ils fusionneront la modification de votre dépôt avec la leur. À ce stade, vous avez apporté avec succès votre première contribution à un projet open source : félicitations !

Vous pouvez supprimer en toute sécurité votre fork du projet une fois la pull request acceptée. Si vous envisagez d'apporter d'autres contributions à l'avenir, vous pouvez conserver le fork, mais vous devrez apprendre à le mettre à jour au fur et à mesure de l'avancement du projet d'origine. Jusqu'à ce que vous soyez à l'aise avec Git et GitHub, il est plus facile d'utiliser le processus ci-dessus et de créer le projet à chaque fois que vous devez effectuer une mise à jour.

Il existe de nombreux types de projets auxquels vous pouvez désormais contribuer, sans en apprendre beaucoup plus sur Git. En particulier, la fonctionnalité GitHub Pages vous permet d'héberger gratuitement un site Web de projet et de le gérer comme n'importe quel autre référentiel. Vous pouvez utiliser l'icône Modifier pour apporter des modifications à votre site Web en temps réel, le tout dans le confort d'un navigateur Web.