pull-request.md

#Faire une “Pull Request”

Les Pull Requests sont le coeur du travail collaboratif sur Github. Lorsque vous faîtes une Pull Request, vous proposez une modification et demandez quelqu’un qu’elle le “pull” (tire en anglais) vers sa version du projet, en gros qu’elle le “merge” sur sa branche. Vous pouvez ainsi comparer le contenu de deux branches. Les changements, additions ou suppression d’éléments, appelés des diffs (différences), se mettront en vert ou en rouge.

Dès que vous faîtes un changement dans votre code, vous pouvez faire une Pull Request pour envoyer votre code.

Vous pouvez utiliser les Pull Request pour commencer une discussion à propos de leurs modifications avant même la fin du projet. De cette manière vous pouvez obtenir un retour sur votre projet au fur et à mesure, ou obtenir de l’aide lorsque vous êtes coincé.

Aussi en utilisant le @mention system dans les messages de vos Pulls Requests, vous pouvez demander des retours de personnes ou de teams particulières, où qu’ils soient. C’est un excellent moyen d’apprendre à fonctionner avant de travailler sur un plus gros projet.

Vous pouvez faire une Pull Request dans votre nouveau repository, c’est un très bon entraînement :)

1. Cliquez sur l'icône Pull Request dans votre sidebar, puis une fois sur la page Pull Request, cliquez sur le bouton vert “New pull request”.

2. Sélectionnez la branche que vous avez créé pour la comparer à la branche “Master”.

3. Observez les diffs pour voir les différentes modifications que vous avez effectuées. Assurez-vous qu’il n’y a pas d’erreurs avant de les envoyer.

4. Lorsque vous êtes satisfaits, cliquez sur le bouton vert “Create pull request”.

5. Donnez-lui un titre. S’il est lié à une de vos issues, ajoutez fixes # + le numéro de votre issue dans le titre. Complétez avec une courte description de vos modifications.

6. Quand vous avez tout compléter, cliquez à nouveau sur “Create pull request”.

Maintenant que vous avez faire votre Pull Request, vous allez pouvoir faire un “merge” des deux branches :)

Rendez-vous sur la fiche "Faire un merge" pour apprendre comment faire.