Požiadavka na stiahnutie (PR) je funkcia GitHubu, ktorá vám umožňuje navrhnúť zmeny v úložisku, do ktorého nemáte prístup na zápis. Správcovia úložiska môžu tieto zmeny skontrolovať a ak sa tak rozhodnú, zlúčiť ich do pôvodného úložiska.
Otváranie žiadostí o stiahnutie na GitHub je kľúčové pri prispievaní do projektov s otvoreným zdrojovým kódom a pri spolupráci s inými vývojármi. Naučte sa, ako vytvoriť a otvoriť požiadavku na stiahnutie na GitHub v niekoľkých jednoduchých krokoch.
Krok 1: Rozdelenie úložiska
Forkovanie úložiska na platformu GitHub vytvorí kópiu – inak známu ako „fork“ – tohto úložiska pod vaším účtom. Rozdelenie úložiska vám umožňuje vykonávať zmeny v kóde bez ovplyvnenia pôvodného úložiska.
Ak chcete rozvetviť úložisko, prejdite na jeho hlavnú stránku a kliknite na vidlička tlačidlo v pravom hornom rohu:
Vyplňte názov úložiska (fork) a voliteľný popis a kliknite Vytvorte vidličku:
Teraz ste vytvorili kópiu pôvodného úložiska. Tento nový repozitár je prepojený s pôvodným, takže akékoľvek zmeny, ktoré v kóde vykonáte, možno ľahko porovnať a zlúčiť doň späť.
Krok 2: Vykonanie zmien v kóde
Po rozvetvení úložiska ho možno budete musieť naklonovať do svojho lokálneho počítača v závislosti od množstva a povahy zmien, ktoré chcete navrhnúť. Ak robíte veľmi jednoduché zmeny, ktoré nemusíte testovať, môžete tak urobiť online pomocou webový editor GitHub.
Ak chcete naklonovať úložisko na svoj lokálny počítač pomocou Git, spustite tento príkaz terminálu:
git klonovať
Nahradiť s adresou URL vášho úložiska – nájdete to na GitHub. Tento príkaz naklonuje úložisko na váš lokálny počítač, kde môžete voľne experimentovať a vykonávať zmeny v kóde.
Zmeny by ste mali udržiavať malé a sústredené, pretože veľké žiadosti o stiahnutie môžu byť náročné na kontrolu a zlúčenie. Pokúste sa zachovať svoje zmeny špecifické pre jeden problém alebo funkciu, aby ste ich správcom uľahčili skontrolovať a prijať.
Po vykonaní požadovaných zmien lokálne ich potvrďte a pošlite ich do vidlice GitHub pomocou Gitu.
Krok 3: Otvorenie žiadosti o stiahnutie
Po potvrdení zmien na GitHub by sa vám mala zobraziť výzva, ktorá vás upozorní, že vaša pobočka je o niekoľko „záväzkov“ pred úložiskom, z ktorého ste ju rozdelili, napríklad:
Kliknite na Prispieť rozbaľovacia ponuka. Kliknutím na toto tlačidlo sa zobrazí výzva na otvorenie žiadosti o stiahnutie. Potom kliknite na Otvoriť požiadavku na stiahnutie tlačidlo:
Niektoré úložiská majú špecifické pokyny pre príspevky, ktoré zvyčajne nájdete v súbore CONTRIBUTING.md, ktorý musíte dodržiavať. Pred odoslaním žiadosti o stiahnutie si prečítajte a dodržiavajte tieto pokyny.
Ďalej vyplňte požadované polia a kliknite na Vytvorte požiadavku na stiahnutie tlačidlo:
Správa o odovzdaní by mala byť jasná a stručná a mala by popisovať zmeny, ktoré ste vykonali, a dôvody, ktoré ich viedli. To pomôže správcom pochopiť vaše zmeny a uľahčí im kontrolu kódu.
Po vytvorení sťahovania budete musieť počkať, kým ho správcovia projektu skontrolujú a zlúčia alebo zatvoria. Správcovia môžu mať návrhy alebo spätnú väzbu na vašu požiadavku na stiahnutie. Buďte otvorení zmenám a ochotní vykonať revízie, ak vás o to požiadajú.
Dôležitosť požiadaviek na stiahnutie
Požiadavky na stiahnutie uľahčujú spoluprácu medzi vývojármi tým, že im umožňujú navrhovať zmeny, poskytovať spätnú väzbu a kontrolovať kód. Pomáha to posilniť zmysel pre komunitu a spoluprácu v rámci projektu, čo vedie k väčšiemu počtu príspevkov a rýchlejšiemu rozvoju.
Okrem toho požiadavky na stiahnutie organizujú históriu projektu a vytváranie verzií tak, že umožňujú správcom sledovať rôzne verzie kódu a zmeny vykonané v každej verzii.
