Dans cette unité, nous allons discuter de la manière dont vous pouvez commencer à contribuer à des projets open source.
Nous utiliserons également les issues (problèmes) et les tags (étiquettes) pour trouver des tâches auxquelles contribuer.

Les logiciels open source peuvent être librement utilisés, modifiés et partagés par n’importe qui.
Grâce aux logiciels open source, tout le monde peut consulter, modifier et distribuer un projet à n’importe quelle fin.
L’idée derrière les logiciels open source est que le partage du code mène à des logiciels meilleurs et plus fiables.

Il existe de nombreuses façons de contribuer à des projets open source.
Faire sa première contribution peut souvent être une expérience intimidante, mais cela ne devrait pas l’être.
L’open source est un espace ouvert à tous, et les contributions se font à tous les niveaux.

Trouver un projet open source qui a besoin de contributions

Vous pouvez commencer en réfléchissant aux projets que vous utilisez déjà ou que vous souhaitez utiliser.
Contribuer est plus facile lorsque vous êtes familier avec le projet et sa communauté.

Peut-être qu’en lisant le fichier README d’un projet, vous trouvez un lien cassé ou quelques fautes de frappe.
Peut-être avez-vous remarqué que quelque chose ne fonctionne pas comme prévu, ou que la documentation n’est plus à jour.
Ce sont toutes d’excellentes occasions d’aider et de contribuer au projet.

Utiliser la recherche GitHub

Vous pouvez également utiliser la recherche GitHub pour explorer des sujets et des projets associés.
Rendez-vous sur la recherche GitHub et entrez le mot-clé de votre sujet.

Par exemple, disons que vous vous intéressez au machine learning (apprentissage automatique).

Vous pouvez ensuite affiner votre recherche en sélectionnant Sujets (Topics) dans la barre latérale gauche.

À partir de là, vous pouvez trouver des dépôts pertinents en fonction de votre mot-clé de recherche, ainsi que des dépôts sélectionnés par des membres de la communauté.

Se familiariser avec un projet open source

Il est important de mentionner que chaque communauté open source est différente.
Une fois que vous avez trouvé un projet, vous devrez vous familiariser avec le projet et ses règles de participation.

La plupart des projets contiennent les documents suivants à la racine du dépôt :

• LICENSE : Le projet doit contenir une licence open source. Si le projet n’a pas de licence, ce n’est pas un projet open source.
• README : Le fichier README sert généralement de page d’accueil pour le projet. Il fournit généralement des informations sur la manière de commencer à utiliser le projet. Il est aussi courant qu’il contienne des informations sur la manière d’interagir avec la communauté.
• CONTRIBUTING : Comme son nom l’indique, ce document fournit des instructions sur la manière de contribuer au projet. Il décrit généralement le processus de contribution et inclut des détails sur la configuration de votre environnement de développement.
• CODE_OF_CONDUCT : Le code de conduite établit des règles de base pour les membres de la communauté. Il contribue à faire de la communauté un environnement sûr et accueillant pour tous.

Bien que tous les projets ne disposent pas des documents CONTRIBUTING ou CODE_OF_CONDUCT, leur présence est un bon indicateur du caractère accueillant et bienveillant d’un projet.

Canaux de communication dans les projets open source

Les contributeurs et mainteneurs open source viennent du monde entier.
Les projets disposent généralement de plusieurs canaux de communication pour organiser les discussions et demander de l’aide.
Une bonne façon de se familiariser avec la communauté est de consulter certains de ces canaux :

• Issue tracker : C’est là que les utilisateurs discutent des problèmes et des tâches liées au projet. Pour trouver les issues sur GitHub, allez sur la page principale du dépôt et ajoutez /issues à la fin de l’URL, par exemple :
  https://github.com/jupyter/notebook/issues
• Pull requests : C’est là que les utilisateurs discutent et examinent les modifications apportées au projet. Vous pouvez y accéder en ajoutant /pulls à l’URL du projet, par exemple :
  https://github.com/jupyter/notebook/pulls
• Canaux de discussion et forums : Certains projets utilisent des canaux de discussion comme Slack, Gitter, IRC, ou des forums comme Discourse pour les conversations et les échanges.

Identifier les tâches sur lesquelles travailler

Vous avez trouvé un projet, vous avez lu les directives de contribution, et vous êtes maintenant prêt à contribuer.

Peut-être avez-vous déjà repéré une tâche à effectuer, comme corriger des liens cassés ou mettre à jour la documentation.
Une bonne façon de trouver des issues adaptées aux débutants est de visiter l’URL /contribute du projet, par exemple : https://github.com/jupyter/notebook/contribute

Vous remarquerez que la plupart des problèmes affichés dans l’URL auront des étiquettes telles que contribute, good-first-issue, help wanted, beginner-friendly, etc. Les étiquettes sont souvent utilisées pour fournir des informations générales sur le problème et le type d’aide nécessaire.

Vous pouvez vous rendre sur la page des étiquettes, par exemple https://github.com/jupyter/notebook/labels. Ensuite, sélectionnez les problèmes qui ont des étiquettes comme help wanted, discussion ou d’autres étiquettes pertinentes selon le type de contribution qui vous intéresse.

En explorant les problèmes, vous remarquerez peut-être aussi que certains ont d’autres problèmes ou des pull requests liés.

Soutenir un projet

Il existe de nombreuses façons de contribuer à l’open source. Vous pouvez soutenir financièrement les personnes qui construisent et maintiennent l’écosystème open source à travers le code, le leadership, le mentorat, le design, et bien plus encore.

L’open source repose fortement sur le travail bénévole. GitHub Sponsors vous permet de financer des projets et des individus pour les aider à poursuivre leur travail open source, tout en leur offrant la reconnaissance qu’ils méritent.

Si un projet est éligible au parrainage via GitHub Sponsors, vous trouverez un bouton Sponsor sur la page principale du projet.

Vous pouvez sélectionner le niveau de parrainage et si vous souhaitez que votre contribution soit publique.

Récapitulatif de l’unité

Dans cette unité, vous avez appris comment débuter dans les contributions open source. Vous savez maintenant comment choisir un projet sur lequel travailler et utiliser les issues et les étiquettes GitHub pour identifier les tâches à réaliser.

Voici une liste de vérification pratique à utiliser lorsque vous interagissez avec un projet pour la première fois :

• Le projet a-t-il une licence ?
• Les discussions autour des issues et des pull requests sont-elles activement utilisées par les mainteneurs et les contributeurs ?
• Le projet utilise-t-il des étiquettes comme help wanted ou good first issue pour les nouveaux contributeurs ?
• Le projet a-t-il un code de conduite ?
• Le projet dispose-t-il de directives de contribution claires ?

Enfin, souvenez-vous que toutes les contributions sont les bienvenues, et que l’écosystème open source bénéficie grandement de vos idées et de votre participation. Il existe de nombreuses façons de contribuer à l’open source, que ce soit en soumettant du code, en participant aux discussions du projet ou en soutenant financièrement les projets via GitHub Sponsors.