Terug naar begrippenlijst
Pull request
Een pull request is veel meer dan een simpele aanvraag om je code toe te voegen aan de hoofdtak van een project. Het is hét moment waarop je collega’s een kijkje nemen in jouw werk, feedback geven en samen met jou zorgen dat de kwaliteit van de code hoog blijft. Je vraagt als het ware officieel toestemming om je bijdrage toe te voegen aan het grotere geheel. Zo blijft iedereen scherp, leren teams van elkaar en voorkom je dat slordige of onnodig complexe code zomaar in de codebase terechtkomt.
Inhoudsopgave
Waarom een pull request veel meer is dan een vinkje zetten
Een pull request is niet alleen een technische formaliteit, maar vooral een kans om samen te werken aan betere code. Het dwingt je om bewust na te denken over wat je hebt gebouwd, waarom je bepaalde keuzes hebt gemaakt en hoe je dat duidelijk overbrengt naar je team. Tegelijkertijd geeft het je collega’s de mogelijkheid om vragen te stellen, verbeteringen voor te stellen en hun eigen kennis te delen. Het is dus geen vervelende hobbel in het proces, maar juist een waardevol moment van samenwerking en kennisdeling.
Van idee naar merge: Zo loopt het proces in de praktijk
Een pull request start op het moment dat jouw werk klaar is. Nadat je je wijzigingen hebt doorgevoerd in je eigen branch, stuur je die branch door naar de centrale repository op een platform als GitHub, GitLab of Bitbucket. Daar maak je een pull request aan, waarin je uitlegt wat je hebt aangepast en waarom. Jouw teamgenoten ontvangen een seintje dat er een nieuwe pull request klaarstaat en nemen de tijd om jouw werk te beoordelen. Ze stellen vragen, geven suggesties of leggen uit waarom bepaalde keuzes misschien slimmer kunnen. Pas als iedereen tevreden is, wordt je code samengevoegd met de hoofdtak en is jouw bijdrage officieel onderdeel van het project.
Pull request of merge? Dit is het verschil
Hoewel de termen vaak door elkaar worden gebruikt, zijn een pull request en een merge niet hetzelfde. Een pull request is de aanvraag waarin je vraagt om je wijzigingen te laten beoordelen en samen te voegen met de hoofdbranch. Een merge is de uiteindelijke stap waarbij de goedgekeurde wijzigingen daadwerkelijk in de hoofdcode worden opgenomen. De pull request is dus de discussie en de beoordeling, de merge is het technische samenvoegen van de code.
Hoe je pull request soepel door de review komt
Een goede pull request is helder, beknopt en overzichtelijk. Het helpt als je duidelijk uitlegt waarom je bepaalde keuzes hebt gemaakt en hoe jouw wijzigingen bijdragen aan het project. Grote lappen code zijn lastig te beoordelen, dus kleinere, gerichte pull requests maken het voor je team een stuk makkelijker. Door je code vooraf zelf kritisch door te nemen, zorg je dat de reviewers zich kunnen richten op inhoudelijke feedback in plaats van kleine slordigheidsfoutjes. Als er feedback komt, is het belangrijk om open te staan voor discussie en te laten zien dat je meedenkt over de beste oplossing. Zo wordt je pull request niet alleen sneller geaccepteerd, maar draag je ook bij aan een betere samenwerking binnen je team.
Veelgestelde vragen
Niet helemaal. Een pull request is de aanvraag om je code te reviewen. De code review zelf is het proces waarin je collega’s je code controleren en feedback geven.
Bij professionele teams en open source projecten meestal wel. Voor snelle solo-projecten kan het soms overbodig zijn.
Ja, als je extra commits toevoegt aan dezelfde branch, komen die automatisch in de open pull request terecht.
De bekendste zijn GitHub, GitLab en Bitbucket, maar vrijwel elk platform dat Git ondersteunt, biedt vergelijkbare functies.
Remco Thijssen Back-end developer
