Een pull request (PR) is een GitHub-functie waarmee je wijzigingen kunt voorstellen aan een repository waartoe je geen schrijftoegang hebt. De beheerders van de repository kunnen deze wijzigingen bekijken en, als ze dat willen, ze samenvoegen met de oorspronkelijke repository.
Het openen van pull-aanvragen op GitHub is cruciaal om bij te dragen aan open-sourceprojecten en om samen te werken met andere ontwikkelaars. Leer hoe u in een paar eenvoudige stappen een pull-aanvraag op GitHub kunt maken en openen.
Stap 1: Forking van de repository
Een repository op forken het GitHub-platform maakt een kopie - ook wel bekend als een "fork" - van die repository, onder uw account. Door een repository te forken, kunt u wijzigingen in de code aanbrengen zonder de oorspronkelijke repository te beïnvloeden.
Om een repository te splitsen, navigeert u naar de hoofdpagina en klikt u op de vork knop in de rechterbovenhoek:
Vul de repositorynaam (fork) en een optionele beschrijving in en klik Vork maken:
Nu heb je een kopie gemaakt van de originele repository. Deze nieuwe repository heeft een verbinding met het origineel, zodat alle wijzigingen die u in de code aanbrengt, eenvoudig kunnen worden vergeleken en er weer in kunnen worden samengevoegd.
Stap 2: wijzigingen aanbrengen in de code
Nadat u de repository heeft gesplitst, moet u deze mogelijk naar uw lokale computer klonen, afhankelijk van de hoeveelheid en de aard van de wijzigingen die u wilt voorstellen. Als u zeer eenvoudige wijzigingen aanbrengt die u niet hoeft te testen, kunt u dit online doen met behulp van de GitHub webgebaseerde editor.
Voer deze terminalopdracht uit om een repository naar uw lokale computer te klonen met Git:
gek kloon
Vervangen met de URL van je repository - je kunt deze vinden op GitHub. Met deze opdracht wordt de repository naar uw lokale computer gekloond, waar u vrijelijk kunt experimenteren en wijzigingen in de code kunt aanbrengen.
U moet uw wijzigingen klein en gericht houden, aangezien grote pull-aanvragen een uitdaging kunnen zijn om te beoordelen en samen te voegen. Probeer uw wijzigingen specifiek te houden voor één probleem of functie, om het voor de beheerders gemakkelijker te maken ze te beoordelen en te accepteren.
Nadat je de gewenste wijzigingen lokaal hebt aangebracht, commit je ze en push je ze naar je GitHub-vork Git gebruiken.
Stap 3: Een pull-aanvraag openen
Nadat je je wijzigingen hebt doorgevoerd in GitHub, zou je een prompt moeten zien die je waarschuwt dat je branch een aantal "commits" voorligt op de repository waaruit je het hebt geforkt, bijvoorbeeld:
Klik op de Bijdragen laten vallen. Als u op deze knop klikt, wordt u gevraagd een pull-aanvraag te openen. Klik vervolgens op de Pull-verzoek openen knop:
Sommige opslagplaatsen hebben specifieke richtlijnen voor bijdragen, die u meestal kunt vinden in een CONTRIBUTING.md-bestand, die u moet volgen. Zorg ervoor dat u deze richtlijnen leest en volgt voordat u een pull-aanvraag indient.
Vul vervolgens de vereiste velden in en klik op de Pull-aanvraag maken knop:
Je commit-bericht moet duidelijk en beknopt zijn, met een beschrijving van de wijzigingen die je hebt aangebracht en de redenering erachter. Dit zal beheerders helpen uw wijzigingen te begrijpen en het voor hen gemakkelijker maken om de code te beoordelen.
Nadat u uw pull hebt gemaakt, moet u wachten tot de beheerders van het project deze hebben beoordeeld en samengevoegd of gesloten. De beheerders hebben mogelijk suggesties of feedback op uw pull-verzoek. Sta open voor veranderingen en ben bereid om herzieningen aan te brengen als ze je daarom vragen.
Het belang van pull-aanvragen
Pull-verzoeken vergemakkelijken de samenwerking tussen ontwikkelaars door hen in staat te stellen wijzigingen voor te stellen, feedback te geven en code te beoordelen. Dit bevordert een gevoel van gemeenschap en samenwerking binnen een project, wat leidt tot meer bijdragen en snellere ontwikkeling.
Bovendien organiseren pull-aanvragen de geschiedenis van het project en het versiebeheer door beheerders in staat te stellen de verschillende versies van de code en de wijzigingen die in elke versie zijn aangebracht, bij te houden.