Pull Requests - Approving a Pull Request

How to approve a pull request, the second and final step in incorporating .do file updates in the master templates (Français ci-dessous)

Video: Pull Requests-Approving Pull Requests

Summary

Walks users through how to approve pull requests. If a user has been assigned a pull request, they will receive an email from GitHub

By the end of this video, you should be able to:

• Open a pull request on GitHub.com
• Review the changes made in a pull request
• Comment on changes in the pull request if necessary
• Send a pull request back with feedback for improvement
• Approve a pull request
• Merge a pull request

How To

How to approve a pull request on GitHub:

1. Navigate to the repository where the pull request was submitted
2. Click on “Pull Request” on the top menu
3. This opens the Pull Request history page, click on the pull request that you want to approve
4. This opens the Pull Request Conversation Page, which contains an overview of the contents of the pull request
   • Username of the person who made the pull request
   • The pull request description
   • Overview of each commit
   • Comment box
   • Merge pull request button – how to approve the pull request
5. There are three ways to review the contents of the commits submitted in a pull request
   • Click on “Commit”
     • Takes you to another list of the commits, when you click on one of the commits, it brings you to a diff viewer for that commit
   • Click directly on the commits
     • Takes you to a diff viewer for that commit
   • Click on “Files Changed”
     • Takes you to a diff viewer for the file
     • Here, you can make comments and select “request changes” and “submit review” if you want someone to make revisions to the commit before it can be approved
6. To approve the pull request, on the Pull Request Conversation Page, scroll to the bottom
   • Click on “Merge Pull Request”
   • Click on “Confirm Merge”

Glossary of terms:

Term	Definition
Commit	A commit is a way to save a change to a file that also stores information on what changes were made, when and by who. PMA uses commits to systematically document changes to .do files
Master	The default branch that is made each time a new repository is created. At PMA, the master branch contains the template of any give .do file. No changes should be made in the master branch
Merge	Takes the changes from one branch and applies them into another branch, often via a pull request. PMA uses merges to share updates to the .do file templates
Pull Request	Proposed changes to a repository submitted by a user and accepted or rejected by the repository’s collaborators. PMA uses pull requests to integrate updates to .do files into the templates and share between countries.
Repository	Contains all of the project files and documentation and stores each file’s revision history. Can have multiple collaborators. PMA keeps its .do files in repositories that are organized by survey type and action

---

Pull Requests - Autoriser une Pull Request

Comment autoriser une pull request, deuxième et dernière étape de l’incorporation des mises à jour des .do files aux modèles master

Vidéo: Les Pull Requests - Approuver une Pull Request

Résumé

Explique à l’utilisateur/trice comment autoriser une pull request. Si une pull request a été assignée à un(e) utilisateur/trice, il/elle recevra un email de GitHub

A la fin de la vidéo, vous devriez être en mesure de :

• Ouvrir pull request sur GitHub.com
• Examiner les modifications d’une pull request
• Commenter les modifications de la pull request si nécessaire
• Renvoyer une pull request avec du feedback pour qu’elle soit améliorée
• Approuver une pull request
• Fusionner (merge) une pull request

Comment Faire

Comment autoriser une pull request sur GitHub:

1. Allez dans le repository où la pull request a été envoyée
2. Cliquez sur “Pull Request” dans le menu du haut
3. Cela ouvrira l’historique de la Pull Request ; ensuite, cliquez sur la pull request que vous voulez autoriser
4. Cela ouvrira la page de conversation de la Pull Request, qui permet de visualiser les contenus de la pull request
   • Nom d’utilisateur de la personne qui a proposé la pull request
   • Description de la pull request
   • Aperçu de chaque commit
   • Encadré pour commentaires
   • Bouton Merge pour la pull request– comment autoriser la pull request
5. Les contenus des commits envoyés dans une pull request peuvent être revus de trois manières :
   • Cliquez sur “Commit”
     • Vous amène vers une autre liste de commits, et lorsque vous cliquez sur l’un des commits, vous serez redirigé(e) en lecture diff de ce commit
   • Cliquez directement sur les commits
     • Lecture diff de ce commit
   • Cliquez sur “Files Changed” (Fichiers modifiés)
     • Lecture diff du fichier
     • Ici, vous pouvez faire des commentaires et sélectionner “request changes” (demander une modification) et “submit review” (envoyer une révision) si vous souhaitez que quelqu’un apporte des modifications à un commit avant de l’autoriser.
6. Pour autoriser une pull request, sur la page de conversation de la Pull Request, allez en bas :
   • Cliquez sur “Merge Pull Request” (Fusionner la pull request)
   • Cliquez sur “Confirm Merge” (Confirmer la fusion)

Glossaire :

Terme	Definition
Commit	Manière de sauvegarder une modification d’un fichier en stockant aussi des informations sur les changements qui ont été faits, quand et par qui. PMA utilise des commits pour documenter systématiquement les modifications des .do files
Master	Branch par défaut générée à chaque fois qu’un nouveau repository est créé. À PMA, la master branch contient le modèle de chaque .do file. Aucune modification ne devrait être apportée à la master branch
Merge	Applique les modifications d’une branch à une autre branch, souvent via une pull request. PMA utilise la fonction merge pour partager des mises à jour de modèles de .do files
Pull Request	Modifications proposées pour un repository par un(e) utilisateur/trice et acceptées ou rejetées par les collaborateurs du repository. PMA utilise les pull requests pour intégrer les mises à jour des .do files aux modèles et les partager entre les pays.
Repository	Contient tous les fichiers et la documentation du projet, et stocke l’historique de révision de chaque fichier. Peut avoir plusieurs collaborateurs. PMA garde ses .do files dans des repositories organisés par type d’enquête et d’action