Pull request (PR) je funkce GitHubu, která vám umožňuje navrhovat změny v úložišti, do kterého nemáte přístup pro zápis. Správci úložiště mohou tyto změny zkontrolovat a pokud se rozhodnou, začlenit je do původního úložiště.
Otevírání žádostí o stažení na GitHubu je zásadní pro přispívání do projektů s otevřeným zdrojovým kódem a pro spolupráci s dalšími vývojáři. Naučte se, jak vytvořit a otevřít žádost o stažení na GitHubu v několika jednoduchých krocích.
Krok 1: Rozvětvení úložiště
Forkování úložiště na platformu GitHub vytvoří kopii – jinak známou jako „fork“ – tohoto úložiště pod vaším účtem. Rozvětvení úložiště vám umožňuje provádět změny v kódu bez ovlivnění původního úložiště.
Chcete-li rozdělit úložiště, přejděte na jeho hlavní stránku a klikněte na Vidlička tlačítko v pravém horním rohu:
Vyplňte název úložiště (fork) a volitelný popis a klikněte Vytvořte vidličku:
Nyní jste vytvořili kopii původního úložiště. Toto nové úložiště má spojení s původním úložištěm, takže jakékoli změny, které v kódu provedete, lze snadno porovnat a začlenit do něj zpět.
Krok 2: Provádění změn v kódu
Po rozvětvení úložiště jej možná budete muset naklonovat do místního počítače, v závislosti na množství a povaze změn, které chcete navrhnout. Pokud provádíte velmi jednoduché změny, které nemusíte testovat, můžete tak učinit online pomocí webový editor GitHub.
Chcete-li naklonovat úložiště do místního počítače pomocí systému Git, spusťte tento příkaz terminálu:
git klon
Nahradit s adresou URL vašeho úložiště – najdete ji na GitHubu. Tento příkaz naklonuje úložiště na váš místní počítač, kde můžete volně experimentovat a provádět změny v kódu.
Měli byste udržovat své změny malé a cílené, protože velké žádosti o stažení mohou být náročné na kontrolu a sloučení. Pokuste se zachovat své změny specifické pro jeden problém nebo funkci, abyste správcům usnadnili jejich kontrolu a přijetí.
Po provedení požadovaných změn lokálně je potvrďte a odešlete do vidlice GitHub pomocí Git.
Krok 3: Otevření požadavku na stažení
Poté, co provedete potvrzení změn na GitHubu, měli byste vidět výzvu, která vás upozorní, že vaše větev je o několik „závazků“ před repozitářem, ze kterého jste ji forkovali, například:
Klikněte na Přispět rozevírací seznam. Klepnutím na toto tlačítko budete vyzváni k otevření požadavku na stažení. Poté klikněte na Otevřete žádost o stažení knoflík:
Některá úložiště mají specifické pokyny pro příspěvky, které obvykle najdete v souboru CONTRIBUTING.md a které musíte dodržovat. Než odešlete žádost o stažení, přečtěte si a dodržujte tyto pokyny.
Dále vyplňte požadovaná pole a klikněte na Vytvořit požadavek na stažení knoflík:
Vaše zpráva o odevzdání by měla být jasná a stručná a měla by popisovat změny, které jste provedli, a jejich zdůvodnění. To pomůže správcům porozumět vašim změnám a usnadní jim kontrolu kódu.
Jakmile vytvoříte svůj pull, budete muset počkat, až ho správci projektu zkontrolují a sloučí nebo zavře. Správci mohou mít návrhy nebo zpětnou vazbu na váš požadavek na stažení. Buďte otevření změnám a ochotni provést revize, pokud vás o to požádají.
Význam požadavků na stažení
Pull requesty usnadňují spolupráci mezi vývojáři tím, že jim umožňují navrhovat změny, poskytovat zpětnou vazbu a kontrolovat kód. To pomáhá podporovat pocit komunity a spolupráce v rámci projektu, což vede k většímu počtu příspěvků a rychlejšímu rozvoji.
Požadavky na stažení dále organizují historii projektu a verzování tím, že umožňují správcům sledovat různé verze kódu a změny provedené v každé verzi.
