Mis à jour le 12/12/2016
  • 6 heures
  • Facile

Ce cours est visible gratuitement en ligne.

Ce cours est en vidéo.

Vous pouvez obtenir un certificat de réussite à l'issue de ce cours.

Vous pouvez être accompagné et mentoré par un professeur particulier par visioconférence sur ce cours.

J'ai tout compris !

Contribuez à des projets open source

Connectez-vous ou inscrivez-vous gratuitement pour bénéficier de toutes les fonctionnalités de ce cours !

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. 

 

 

 

 

Exemple de certificat de réussite
Exemple de certificat de réussite