pull request
/ˈpʊl rɪˌkwest/zelfstandig naamwoord
Een pull request is een voorstel om wijzigingen uit een branch te beoordelen en samen te voegen met een andere branch. Teamleden kunnen de code bespreken en controleren voordat deze wordt opgenomen.
De developer opende een pull request en vroeg twee collega's om de wijziging te beoordelen.
Een pull request bundelt de wijzigingen uit een Woordenboek · In het kortbranchEen branch is een afzonderlijke ontwikkellijn binnen versiebeheer. Developers kunnen daarin wijzigingen maken en testen zonder de hoofdversie van de code direct aan te passen.Lees meer en biedt die ter beoordeling aan. De auteur beschrijft wat er is aangepast en waarom. Reviewers kunnen vervolgens de verschillen bekijken, opmerkingen plaatsen en vragen om aanpassingen. Met het verzoek vraagt de auteur om de wijzigingen naar een andere branch te halen.
Van voorstel naar samenvoeging
Een developer maakt meestal eerst een aparte branch en legt het werk vast in een of meer Woordenboek · In het kortcommitEen commit is een vastgelegde versie van bestanden in een systeem voor versiebeheer. Elke commit vormt een punt in de ontwikkelgeschiedenis van een project.Lees meer. Daarna opent diegene een pull request naar de gewenste doelbranch, vaak de hoofdbranch. Het ontwikkelplatform toont welke bestanden en regels zijn gewijzigd. Automatische tests en andere controles kunnen direct bij het voorstel worden uitgevoerd.
De auteur kan na feedback nieuwe commits toevoegen. Die verschijnen dan in hetzelfde pull request. Zodra de controles zijn geslaagd en de benodigde goedkeuringen zijn gegeven, kan de branch worden samengevoegd. Een pull request is dus het voorstel en het gesprek rond een wijziging; de merge is de handeling waarmee de code daadwerkelijk in de doelbranch terechtkomt.
Pull request en merge request
Pull request en merge request zijn twee namen voor vrijwel dezelfde werkwijze. GitHub en Bitbucket gebruiken doorgaans pull request, terwijl GitLab spreekt van merge request. In beide gevallen gaat het om een afgebakende codewijziging die teamleden kunnen bespreken, controleren en goedkeuren.
Een pull request hoeft niet te eindigen met een merge. De auteur kan het voorstel sluiten als de aanpak vervalt of door een andere oplossing wordt vervangen. De discussie en eerdere versies blijven op het ontwikkelplatform meestal terug te vinden.