En pull-begäran (PR) är en GitHub-funktion som låter dig föreslå ändringar i ett arkiv som du inte har skrivåtkomst till. Förvarets underhållare kan granska dessa ändringar och, om de så önskar, slå samman dem till det ursprungliga förvaret.
Att öppna pull-förfrågningar på GitHub är avgörande för att bidra till projekt med öppen källkod och för att samarbeta med andra utvecklare. Lär dig hur du skapar och öppnar en pull-förfrågan på GitHub med bara några enkla steg.
Steg 1: Forking the Repository
Forking ett förråd på GitHub-plattformen skapar en kopia - annars känd som en "gaffel" - av det förrådet, under ditt konto. Forking av ett arkiv låter dig göra ändringar i koden utan att påverka det ursprungliga arkivet.
För att dela ett arkiv, navigera till dess huvudsida och klicka på gaffel knappen i det övre högra hörnet:
Fyll i förvarets namn (gaffel) och en valfri beskrivning och klicka Skapa gaffel:
Nu har du skapat en kopia av originalförrådet. Det här nya arkivet har en koppling till originalet så att alla ändringar du gör i koden enkelt kan jämföras och slås samman tillbaka till den.
Steg 2: Göra ändringar i koden
Efter att du har splittrat förvaret kan du behöva klona det till din lokala dator, beroende på mängden och arten av ändringar du vill föreslå. Om du gör mycket enkla ändringar som du inte behöver testa kan du göra det online med hjälp av den webbaserade GitHub-redigeraren.
För att klona ett arkiv till din lokala maskin med Git, kör detta terminalkommando:
git klona
Byta ut med ditt förvars URL - du kan hitta detta på GitHub. Detta kommando kommer att klona förvaret till din lokala dator, där du fritt kan experimentera och göra ändringar i koden.
Du bör hålla dina ändringar små och fokuserade, eftersom stora pull-förfrågningar kan vara utmanande att granska och slå samman. Försök att hålla dina ändringar specifika för ett problem eller funktion, för att göra det lättare för underhållarna att granska och acceptera dem.
Efter att du har gjort dina önskade ändringar lokalt, förverkliga dem och tryck dem till din GitHub-gaffel använder Git.
Steg 3: Öppna en Pull-förfrågan
Efter att du har genomfört dina ändringar till GitHub, bör du se en prompt som varnar dig om att din filial är ett antal "commits" före arkivet du klaffade den från, till exempel:
Klicka på Bidra falla ner. Om du klickar på den här knappen uppmanas du att öppna en pull-begäran. Klicka sedan på Öppna pull-begäran knapp:
Vissa arkiv har specifika bidragsriktlinjer, som du vanligtvis kan hitta i en CONTRIBUTING.md-fil, som du måste följa. Se till att läsa och följa dessa riktlinjer innan du skickar in en pull-begäran.
Fyll sedan i de obligatoriska fälten och klicka på Skapa pull-förfrågan knapp:
Ditt engagemangmeddelande bör vara tydligt och koncist, beskriva de ändringar du gjort och resonemanget bakom dem. Detta kommer att hjälpa underhållare att förstå dina ändringar och göra det lättare för dem att granska koden.
När du har skapat din pull måste du vänta på att projektets underhållare ska granska och slå samman det eller stänga det. Underhållarna kan ha förslag eller feedback på din pull-förfrågan. Var öppen för ändringar och villig att göra ändringar om de ber dig om det.
Vikten av Pull-förfrågningar
Pull-förfrågningar underlättar samarbete mellan utvecklare genom att de kan föreslå ändringar, ge feedback och granska kod. Detta bidrar till att främja en känsla av gemenskap och samarbete inom ett projekt, vilket leder till fler bidrag och snabbare utveckling.
Dessutom organiserar pull-förfrågningar projektets historik och versionshantering genom att tillåta underhållare att hålla reda på de olika versionerna av koden och de ändringar som gjorts i varje version.