En pull request (PR) er en GitHub-funktion, der giver dig mulighed for at foreslå ændringer til et lager, som du ikke har skriveadgang til. Repository-vedligeholderne kan gennemgå disse ændringer og, hvis de ønsker det, flette dem ind i det originale repository.
Åbning af pull-anmodninger på GitHub er afgørende for at bidrage til open source-projekter og samarbejde med andre udviklere. Lær, hvordan du opretter og åbner en pull-anmodning på GitHub i nogle få nemme trin.
Trin 1: Fordeling af depotet
Forgrening af et depot GitHub platformen opretter en kopi – ellers kendt som en "gaffel" – af det depot under din konto. Forking af et lager giver dig mulighed for at foretage ændringer i koden uden at påvirke det originale lager.
For at fordele et lager skal du navigere til dets hovedside og klikke på gaffel knap i øverste højre hjørne:
Udfyld lagernavnet (gaffel) og en valgfri beskrivelse og klik Opret gaffel:
Nu har du oprettet en kopi af det originale lager. Dette nye repository har en forbindelse med originalen, så eventuelle ændringer, du foretager i koden, nemt kan sammenlignes og flettes ind i den igen.
Trin 2: Foretag ændringer af koden
Efter du har fordelt depotet, skal du muligvis klone det til din lokale maskine, afhængigt af mængden og arten af ændringer, du ønsker at foreslå. Hvis du laver meget enkle ændringer, som du ikke behøver at teste, kan du gøre det online ved hjælp af den webbaserede GitHub-editor.
For at klone et lager til din lokale maskine ved hjælp af Git, kør denne terminalkommando:
git klon
Erstatte med dit depots URL - du kan finde dette på GitHub. Denne kommando vil klone lageret til din lokale maskine, hvor du frit kan eksperimentere og foretage ændringer i koden.
Du bør holde dine ændringer små og fokuserede, da store pull-anmodninger kan være udfordrende at gennemgå og flette. Prøv at holde dine ændringer specifikke for et problem eller en funktion, for at gøre det nemmere for vedligeholdere at gennemgå og acceptere dem.
Når du har foretaget dine ønskede ændringer lokalt, skal du forpligte dem og skubbe dem til din GitHub-gaffel ved hjælp af Git.
Trin 3: Åbning af en pull-anmodning
Når du har begået dine ændringer til GitHub, bør du se en prompt, der advarer dig om, at din filial er et antal "commits" foran det lager, du forkastede den fra, for eksempel:
Klik på Bidrage dropdown. Hvis du klikker på denne knap, bliver du bedt om at åbne en pull-anmodning. Klik derefter på Åbn pull-anmodning knap:
Nogle repositories har specifikke bidragsvejledninger, som du typisk kan finde i en CONTRIBUTING.md-fil, som du skal følge. Sørg for at læse og følge disse retningslinjer, før du sender en pull-anmodning.
Udfyld derefter de påkrævede felter og klik på Opret pull-anmodning knap:
Dit forpligtelsesbudskab skal være klart og kortfattet og beskrive de ændringer, du har foretaget, og begrundelsen bag dem. Dette vil hjælpe vedligeholdere med at forstå dine ændringer og gøre det nemmere for dem at gennemgå koden.
Når du har oprettet dit pull, skal du vente på, at projektets vedligeholdere gennemgår og fusionerer det eller lukker det. Vedligeholderne kan have forslag eller feedback på din pull-anmodning. Vær åben over for ændringer og villig til at foretage revisioner, hvis de beder dig om det.
Vigtigheden af Pull-anmodninger
Pull-anmodninger letter samarbejdet mellem udviklere ved at give dem mulighed for at foreslå ændringer, give feedback og gennemgå kode. Dette er med til at fremme en følelse af fællesskab og samarbejde inden for et projekt, hvilket fører til flere bidrag og hurtigere udvikling.
Ydermere organiserer pull-anmodninger projektets historie og versionering ved at tillade vedligeholdere at holde styr på de forskellige versioner af koden og ændringerne i hver version.
