Zahtjev za povlačenjem (PR) značajka je GitHuba koja vam omogućuje predlaganje promjena u repozitoriju za koji nemate pristup za pisanje. Održavatelji repozitorija mogu pregledati te promjene i, ako žele, spojiti ih u izvorno repozitorij.
Otvaranje zahtjeva za povlačenjem na GitHubu ključno je za doprinos projektima otvorenog koda i suradnju s drugim programerima. Naučite kako stvoriti i otvoriti zahtjev za povlačenje na GitHubu u samo nekoliko jednostavnih koraka.
Korak 1: Račvanje repozitorija
Račvanje spremišta na platformu GitHub stvara kopiju — inače poznatu kao "fork" — tog spremišta, pod vašim računom. Forking repozitorija vam omogućuje da napravite promjene u kodu bez utjecaja na originalni repozitorij.
Za račvanje repozitorija, idite na njegovu glavnu stranicu i kliknite vilica gumb u gornjem desnom kutu:
Ispunite ime repozitorija (fork) i opcijski opis i kliknite Stvorite vilicu:
Sada ste stvorili kopiju izvornog repozitorija. Ovo novo spremište ima vezu s izvornikom tako da se sve promjene koje napravite u kodu mogu lako usporediti i ponovno spojiti u njega.
Korak 2: Izmjene koda
Nakon što račvate repozitorij, možda ćete ga morati klonirati na svoj lokalni stroj, ovisno o količini i prirodi promjena koje želite predložiti. Ako radite vrlo jednostavne promjene koje ne morate testirati, to možete učiniti putem interneta GitHub web uređivač.
Za kloniranje repozitorija na vaš lokalni stroj pomoću Gita, pokrenite ovu naredbu terminala:
git klon
Zamijeniti s URL-om vašeg spremišta—ovo možete pronaći na GitHubu. Ova naredba će klonirati repozitorij na vaš lokalni stroj, gdje možete slobodno eksperimentirati i mijenjati kod.
Promjene bi trebale biti male i fokusirane, jer veliki zahtjevi za povlačenjem mogu biti izazovni za pregled i spajanje. Pokušajte zadržati svoje promjene specifične za jedan problem ili značajku, kako bi ih održavatelji lakše pregledali i prihvatili.
Nakon što napravite željene promjene lokalno, izvršite ih i gurnite u svoj GitHub fork koristeći Git.
Korak 3: Otvaranje zahtjeva za povlačenjem
Nakon što ste unijeli svoje promjene u GitHub, trebali biste vidjeti obavijest koja vas upozorava da je vaša grana broj “commitova” ispred repozitorija iz kojeg ste je račvali, na primjer:
Kliknite na Doprinesite padajući izbornik. Klikom na ovaj gumb od vas će se tražiti da otvorite zahtjev za povlačenje. Zatim kliknite na Otvoren zahtjev za povlačenjem dugme:
Neki repozitoriji imaju posebne smjernice za doprinose, koje obično možete pronaći u datoteci CONTRIBUTING.md, a kojih se morate pridržavati. Obavezno pročitajte i slijedite ove smjernice prije nego što pošaljete zahtjev za povlačenje.
Zatim ispunite potrebna polja i kliknite na Kreirajte zahtjev za povlačenjem dugme:
Vaša poruka predaje trebala bi biti jasna i koncizna, opisujući promjene koje ste napravili i razloge koji stoje iza njih. To će pomoći održavateljima da razumiju vaše promjene i olakšati im pregled koda.
Nakon što izradite svoj potez, morat ćete pričekati da ga održavatelji projekta pregledaju i spoje ili zatvore. Održavatelji mogu imati prijedloge ili povratne informacije o vašem zahtjevu za povlačenjem. Budite otvoreni za promjene i spremni izvršiti revizije ako to od vas zatraže.
Važnost zahtjeva za povlačenjem
Zahtjevi za povlačenjem olakšavaju suradnju između programera omogućujući im da predlože promjene, daju povratne informacije i pregledaju kod. To pomaže u poticanju osjećaja zajedništva i suradnje unutar projekta, što dovodi do više doprinosa i bržeg razvoja.
Nadalje, zahtjevi za povlačenjem organiziraju povijest projekta i izradu verzija dopuštajući održavateljima da prate različite verzije koda i promjene u svakoj verziji.