Le Hacktoberfest est un évènement organisé par Dev.to et DigitalOcean dédié à l’Open Source. Il a pour but de promouvoir les contributions sur les projets Open Source sur GitHub.
Mais cet évènement n’est pas réservé qu’aux développeurs chevronnés. Il est ouvert à tous, y compris ceux qui ne sont qu’amateur ou ceux qui ne codent que pour gérer des déploiements ou des infrastructures.
Le principe est simple, if faut s’inscrire avec son compte GitHub sur le site dédié et faire au moins 5 4 Pull Requests sur d’autres repos. Les 50000 premiers participants arrivant à 5 4 PR auront un T-Shirt et surtout la reconnaissance d’avoir participer à des projets dans l’Open Source.
Commençons par le début, comment trouver un projet Open Source sur Github qui puisse vous intéresser.
Il est peut élégant de faire une Pull Request sans y avoir été invité. Une contribution doit pouvoir répondre à une Issue. Une issue sur Github représente une demande d’aide sur un point particulier.
Cela peut comprendre aussi bien la correction d’un Bug, la mise en place d’une documentation (ou même se traduction dans une autre langue, comme le Français), l’ajout d’une fonctionnalité, la création de tests, …
Pour trouver une Issue, vous pouvez naviguer sur Github et chercher sur les répos ou vous pouvez aussi utiliser un site comme http://issuehub.io
http://issuehub.io/?label%5B%5D=hacktoberfest&language=powershell
Sur ce lien sont listées toutes les Issues ayant un Label Hacktoberfest sur les repos utilisant le langage PowerShell.
Dès que vous avez trouver une issue, vous pouvez commencer à travailler dessus.
La première étape est de forker le repos.
En cliquant sur Fork, GitHub copie le repos dans votre propre espace.
Il est alors possible de Cloner le repos depuis votre espace sur votre machine
git clone https://github.com/....
Et vous pouvez travailler.
Attention cependant, certain mainteneur, souhaite parfois que les contributions se fasse sur une branche différente de Master.
Il faut vérifier la présence d’un fichier contribute.md dans le repos qui explique comment faire.
Une fois que vous avez terminé sur votre machine locale vous pouvez envoyer vos changements sur votre espace GitHub.
git add ‘file’
git commit -m ‘Commit description and #Issue’
git push origin master (ou branch)
Mais pour le moment les changements n’ont été fait que sur votre espace. C’est à ce moment que l’on peut effectuer une Pull Request.
Pour cela, il faut se rendre dans son repos sur GitHub et cliquer sur new Pull Request
En cliquant sur ce bouton vous êtes renvoyé vers l’espace original
Il est nécessaire d’inclure l’ID de l’Issue dans le titre et la description et ensuite il faut cliquer sur Create Pull Request
Et voilà ! vous avez fait une premier PR
La balle est maintenant chez le mainteneur qui peut choisir soit d’accepter ou de refuser la PR ou bien de demander des précisions supplémentaires.
Pour aller plus loin vous pouvez aussi regarder https://opensource.guide/how-to-contribute/
Bon Hacktoberfest
Note: Le 1 Octobre le FRPSUG organise un meetup en ligne sur le sujet
Top comments (2)
Juste un truc: Pour le t-shirt, il faut faire 4 Pull Requests en fait, pas 5.
Pour ceux qui se demandent, ça compte même si la PR n'est pas acceptée.
Oui effectivement c'est 4 et pas 5. Il me semblait que l'an dernier c'était 5
Merci je corrige