• 6 hours
  • Easy

Free online content available in this course.

Videos available in this course

Certificate of achievement available at the end this course

You can get support and mentoring from a private teacher via videoconference on this course.

Got it!

Last updated on 4/24/19

Contribuez à des projets open source

Log in or subscribe for free to enjoy all this course has to offer!

Un des aspects passionnants lorsque vous faites du développement, c'est que vous pouvez apporter votre pierre à plein d'édifices en contribuant à des projets open-source. :magicien:

Nous allons voir ici comment proposer une modification à un projet hébergé sur GitHub.  On appelle ça faire une pull request (PR).

Le premier réflexe à avoir est de regarder dans la documentation du projet si des recommandations sont précisées sur comment faire une pull request. Certains peuvent demander d'utiliser un format spécifique pour les messages de commit et de PR, d'ajouter des tests, etc. En général, vous trouverez ces recommandations dans le fichier README, avec un intitulé "Contributing" ou "Pull requests". 

Voici le procédé classique que vous aurez à adapter en fonction des recommandations trouvées dans la doc : 

Step 1 – Récupérez le repo auquel vous souhaitez contribuer

Tout d'abord, faites un fork du repo auquel vous souhaitez contribuer

Cela signifie simplement faire une copie du repo en question sur votre compte GitHub. Pour cela, rendez-vous sur le repo GitHub (ici pour exemple : https://github.com/oc-courses/intro-git-github) et cliquez sur "fork" en haut à droite de la page :

 

 Ensuite, clonez votre copie depuis GitHub sur votre machine

Vous savez faire, il vous suffit de copier l'URL https de la copie du repo que vous avez "forké" sur votre compte GitHub et de la coller dans votre terminal en faisant un git clone. Dans notre exemple, ça donnerait quelque chose comme ça : 

git clone https://github.com/votre-username/intro-git-github.git

Step 2 – Faites vos modifications

Sur votre machine, placez-vous dans le repo que vous venez de créer, créez une nouvelle branche où vous allez faire vos modifications et placez-vous dedans :

git checkout -b my-new-feature

 Faites vos modifications dans la nouvelle branche et "committez"-les dans Git en veillant à rédiger des messages de commit clairs, par exemple : 

git commit -m "Added feature allowing users to comment on the blog articles"

 Envoyez vos modifications sur GitHub en faisant un git push de votre nouvelle branche : 

git push origin my-new-feature

Step 3 – Proposez vos modifications au projet

Une fois vos modifications envoyées sur votre fork GitHub, il vous reste à transmettre votre demande de modifications en faisant une pull request. Pour cela, placez-vous sur votre fork GitHub, sur votre nouvelle branche, et cliquez sur "Compare & pull request".

 Vous allez alors être amenés à rédiger un message pour présenter votre proposition de modifications à l'auteur du projet.

Vous remarquerez que sous votre message, GitHub propose un comparatif détaillé de vos modifications par rapport au projet auquel vous souhaitez contribuer. 

Une fois votre pull request envoyée, l'auteur du projet consultera vos propositions, et vous recevrez une notification par GitHub lorsqu'il/elle les aura intégrées ou refusées. Il se peut aussi qu'il/elle vous contacte pour vous demander des précisions avant d'accepter ou non votre PR. 

 

 

 

 

Example of certificate of achievement
Example of certificate of achievement