Faire une pull request sur Github

Nous prendrons comme exemple le site de l'Association Sans Nom.

Fork

Faites un fork du dépôt original en utilisant le bouton Fork.

Bouton fork sur Github

Clone

Clonez votre nouveau dépôt (le fork).

SSH

Si vous avez ajouté une clé ssh à votre compte Github :

Copier le lien ssh vers le dépôt Github

git clone git@github.com:username/website.git

HTTPS

Sinon :

Copier le lien https vers le dépôt Github

git clone https://github.com/username/website.git

Remote

Ajoutez comme remote l'adresse HTTPS du dépôt original (on l'appellera upstream) :

git add remote upstream https://github.com/asn42/website.git

Branche

Après avoir synchronisé la branch master du remote upstream, créez une nouvelle branche depuis celle-ci et passez dessus pour travailler sur un bug ou une fonctionnalité :

git fetch upstream master
git checkout upstream/master
git checkout -b photo_de_chat

Modifications

Modifiez ensuite le contenu ou le code en essayant de faire des messages de commit explicites.

cp ~/Téléchargements/chaton.jpg content/chaton.jpg
vi content/_index.md
git add content/_index.md content/chaton.jpg
git commit -m "ajoute une photo de chaton sur la page d'accueil"

Garder la branche à jour

Si des modifications ont été fait sur le dépôt original pendant que vous travailliez dans votre branche, vous pouvez mettre à jour votre branche master et les récupérer dans votre branche :

git checkout master
git pull upstream master
git push origin master
git checkout photo_de_chat
git rebase master

Conflits

Si des modifications qui ont été faites sur la branche master entrent en conflit avec vos modifications, résolvez les conflits, puis continuez le rebase.

git rebase --continue

Push

Quand vous êtes satisfait de vos modifications, envoyez les sur votre dépôt :

git push origin photo_de_chat

Pull request

Enfin, faites une pull request sur Github.

Si vous avez poussé vos commits sur la branche récemment, un bouton Compare & pull request pour cette branche est directement visible.

Bouton pull request pour une branche récemment poussée sur Github

Sinon, passez sur la branche en question et utilisez le bouton New pull request.

Voir la branche photo_de_chat sur Github

Bouton pull request sur Github

Vous pouvez ajouter des commentaires à la pull request, puis la soumettre en cliquant sur le bouton Create pull request.

Formulaire de pull request sur Github

Corrections

Si vous avez des améliorations ou des corrections à faire à votre pull request, ou si on vous demande d'y changer quelque chose pour qu'elle puisse être acceptée, vous pouvez ajouter des commits ou en modifier sur la branche sur laquelle vous avez travaillé. Cela sera appliqué à la pull request.