En pull request (PR) er en GitHub-funksjon som lar deg foreslå endringer i et depot du ikke har skrivetilgang til. Lagringsansvarlige kan gjennomgå disse endringene og, hvis de ønsker det, slå dem sammen til det opprinnelige depotet.
Å åpne pull-forespørsler på GitHub er avgjørende for å bidra til åpen kildekode-prosjekter og samarbeide med andre utviklere. Lær hvordan du oppretter og åpner en pull-forespørsel på GitHub i noen få enkle trinn.
Trinn 1: Fordeling av depotet
Forking et depot på GitHub-plattformen oppretter en kopi – ellers kjent som en "gaffel" – av det depotet, under kontoen din. Fordeling av et depot lar deg gjøre endringer i koden uten å påvirke det opprinnelige depotet.
For å dele et depot, naviger til hovedsiden og klikk på gaffel knapp øverst til høyre:
Fyll inn depotnavnet (gaffel) og en valgfri beskrivelse og klikk Lag gaffel:
Nå har du opprettet en kopi av det originale depotet. Dette nye depotet har en forbindelse med originalen slik at eventuelle endringer du gjør i koden enkelt kan sammenlignes og slås sammen tilbake til den.
Trinn 2: Gjør endringer i koden
Etter at du har splittet depotet, må du kanskje klone det til din lokale maskin, avhengig av mengden og arten av endringer du ønsker å foreslå. Hvis du gjør veldig enkle endringer som du ikke trenger å teste, kan du gjøre det online ved å bruke den nettbaserte GitHub-redigereren.
For å klone et depot til din lokale maskin ved hjelp av Git, kjør denne terminalkommandoen:
git klone
Erstatte med depotets URL - du kan finne dette på GitHub. Denne kommandoen vil klone depotet til din lokale maskin, hvor du fritt kan eksperimentere og gjøre endringer i koden.
Du bør holde endringene små og fokuserte, siden store pull-forespørsler kan være utfordrende å gjennomgå og slå sammen. Prøv å holde endringene dine spesifikke for ett problem eller en funksjon, for å gjøre det lettere for vedlikeholderne å gjennomgå og godta dem.
Etter å ha gjort de ønskede endringene lokalt, forplikt dem og skyv dem til GitHub-gaffelen din bruker Git.
Trinn 3: Åpne en pull-forespørsel
Etter at du har foretatt endringene dine til GitHub, bør du se en melding som varsler deg om at grenen din er et antall "forpliktelser" foran depotet du ga den fra, for eksempel:
Klikk på Bidra fall ned. Hvis du klikker på denne knappen, blir du bedt om å åpne en pull-forespørsel. Klikk deretter på Åpne pull-forespørsel knapp:
Noen arkiver har spesifikke bidragsretningslinjer, som du vanligvis finner i en CONTRIBUTING.md-fil, som du må følge. Sørg for å lese og følge disse retningslinjene før du sender inn en pull-forespørsel.
Deretter fyller du ut de nødvendige feltene og klikker på Opprett pull-forespørsel knapp:
Forpliktelsesmeldingen din bør være klar og konsis, og beskrive endringene du har gjort og begrunnelsen bak dem. Dette vil hjelpe vedlikeholdere å forstå endringene dine og gjøre det lettere for dem å se gjennom koden.
Når du har opprettet pull, må du vente på at prosjektets vedlikeholdere ser gjennom og slår det sammen eller lukker det. Vedlikeholderne kan ha forslag eller tilbakemeldinger på pull-forespørselen din. Vær åpen for endringer og villig til å gjøre endringer hvis de ber deg om det.
Viktigheten av Pull-forespørsler
Pull-forespørsler letter samarbeid mellom utviklere ved å gjøre det mulig for dem å foreslå endringer, gi tilbakemelding og gjennomgå kode. Dette bidrar til å fremme en følelse av fellesskap og samarbeid i et prosjekt, noe som fører til flere bidrag og raskere utvikling.
Videre organiserer pull-forespørsler prosjektets historie og versjonering ved å la vedlikeholdere holde styr på de forskjellige versjonene av koden og endringene som er gjort i hver versjon.
