GitHub je webový portál pro vývoj open source softwaru. Jednou z nejdůležitějších a nejužitečnějších funkcí GitHubu je možnost vytvořit fond rekvizit, které účastníkům projektu umožňují provádět změny kódu a nabízet je k zahrnutí do zdrojového kódu projektu. Vytvoření fondu request je nedílnou součástí práce ve vývojovém týmu a přispívá ke spolupráci a zvyšování kvality softwaru, který je vyvíjen.
Vytvoření fondu request na Githubu není obtížné, ale vyžaduje určité znalosti a dovednosti pro práci s touto platformou. V první řadě je nutné mít účet na Githubu a základní dovednosti pro práci s Git. Poté, co jste předem nakonfigurovali a synchronizovali své úložiště s hlavním projektem, můžete začít vytvářet pool request.
Chcete-li vytvořit fond request, přejděte na stránku svého úložiště na Githubu. Vpravo od seznamu souborů v horní části stránky uvidíte tlačítko "požadavky na natažení". Klikněte na ni. Otevře se stránka pro vytvoření fondu request, kde budete moci zadat název pro svůj fond, popis a vybrat, na kterou větev projektu chcete fond request vytvořit. Po vyplnění všech požadovaných polí klikněte na tlačítko"Create Pull Request".
Po vytvoření fondu request se dostanete na stránku s diskusí o vaší navrhované změně. Zde mohou účastníci projektu zanechat komentáře, klást otázky a vyjádřit svůj názor na změny, které provádíte. Vývojáři projektu mohou také přijmout váš fond request, odmítnout jej nebo požádat o další změny. Upozorňujeme, že pool request lze vytvořit nejen pro hlavní projekt, ale také pro další větve, včetně již existujících pool recvest.
Otevřete úložiště na Githubu
- Přejděte na web GitHub.com..
- Přihlaste se ke svému účtu, pokud jste nebyli přihlášeni dříve.
- Na domovské stránce vyhledejte seznam svých úložišť a vyberte požadované.
Můžete také použít vyhledávání, pokud máte mnoho úložišť a nemůžete najít ten správný.
Jakmile otevřete požadované úložiště, budete připraveni přejít k dalšímu kroku - vytvoření nového fondu rekvizit.
a) přihlaste se ke svému účtu
Chcete-li vytvořit fond rekvest na Githubu, musíte se přihlásit ke svému účtu na platformě.
Chcete-li se přihlásit ke svému účtu, přejděte na web github.com a zadejte své přihlašovací údaje: uživatelské jméno a heslo.
Pokud ještě nemáte účet na Githubu, musíte jej vytvořit kliknutím na tlačítko "Sign up" a vyplněním požadovaných polí.
Po úspěšné autorizaci na webu budete přesměrováni na domovskou stránku vašeho účtu, kde můžete začít vytvářet rekvestační fond.
B) Najděte správné úložiště
Chcete-li vytvořit pool request na Githubu, musíte nejprve najít správné úložiště, ve kterém chcete provést změny nebo přidat nový kód. Pomocí vyhledávání na Githubu najdete správné úložiště podle klíčových slov, názvu projektu nebo jména autora. Můžete také použít globální vyhledávání na Githubu k nalezení projektů a úložišť souvisejících s konkrétním tématem nebo programovacím jazykem.
Když najdete požadované úložiště, otevřete jeho stránku a podívejte se na obsah a strukturu projektu. Věnujte pozornost souborům, složkám, větvím a komentářům ostatních vývojářů. To vám pomůže pochopit, kde a jaké změny je třeba provést.
Můžete se také podívat na projektovou dokumentaci, pokud je k dispozici. Dokumentace může obsahovat užitečné informace o procesu provádění změn a očekávaných kódovacích standardech.
Nezapomeňte, že před provedením změn úložiště může být nutné získat přístupová práva od vývojářů projektu. Některá úložiště mohou být uzavřena nebo mohou mít pravidla účasti na vývoji.
Zálohujte úložiště
Před vytvořením fondu request je nutné zálohovat (vytvořit kopii) úložiště, ve kterém jsou provedeny změny, které chcete provést. Fork repozitář znamená vytvořit si na svém účtu vlastní kopii projektu někoho jiného.
Chcete-li zálohovat úložiště na GitHub, musíte:
- Přejděte na stránku úložiště, kterou chcete forkovat.
- Klikněte na tlačítko "Fork" v pravém horním rohu stránky. Kliknutím na toto tlačítko vytvoříte kopii úložiště na svém účtu.
- Po úspěšném forku úložiště budete přesměrováni na stránku své vlastní kopie. Nyní můžete volně provádět změny a provádět komity v tomto úložišti.
Pamatujte, že zálohované úložiště bude sledováno vaším účtem a můžete v něm provádět změny bez omezení. Vaše změny nebudou mít vliv na původní úložiště, dokud nebude vytvořen fond request a nebude provedena fúze změn.
Vytvořte novou větev
Chcete-li vytvořit novou větev na Githubu, postupujte takto:
- Otevřete úložiště, ve kterém chcete vytvořit větev.
- Když jste na domovské stránce úložiště, klikněte na tlačítko "Branch: master" (nebo jiný název aktuální větve).
- Do zobrazeného pole zadejte název nové větve. Název větve musí být popisný a odpovídat typu provedených změn.
- Klikněte na tlačítko "Create new branch" (vytvořit novou větev).
Po vytvoření nové větve můžete provádět změny v souborech projektu. Až budete s úpravami hotovi a budete připraveni je navrhnout ke sloučení, můžete z vytvořené větve vytvořit pool request.
Provádět změny
Před vytvořením fondu request na Githubu musíte provést změny v úložišti, ke kterému chcete přispět. Tyto změny mohou zahrnovat přidávání nebo mazání souborů, úpravy stávajících souborů a mnoho dalších akcí.
Před provedením změn se doporučuje vytvořit samostatnou větev pro vývoj nových funkcí nebo opravu chyb. Vytvoření samostatné větve vám umožňuje pracovat na změnách bez ohledu na hlavní větev projektu a usnadňuje proces slučování změn prostřednictvím fondu request.
Když jste provedli všechny požadované změny ve svém samostatném vláknu, můžete provést commit, abyste zachovali aktuální stav kódu. Doporučuje se napsat smysluplnou zprávu z komuniké, která popisuje provedené změny. To umožní ostatním vývojářům lépe porozumět tomu, co bylo v této zprávě provedeno a proč.
Jakmile dokončíte provádění změn a provedete commit, můžete odeslat své vlákno na vzdálené úložiště GitHub a vytvořit fond request. V Poole request můžete podrobně popsat provedené změny, klást otázky a poukázat na konkrétní oblasti kódu, které potřebují recenzi.
Ostatní vývojáři mohou zanechat komentáře a diskutovat o provedených změnách a poukázat na možné chyby nebo vylepšení. Některé projekty mohou vyžadovat další kroky, jako je testování změn nebo podpis smlouvy o licencování účastníků.
Poté, co byly změny projednány a schváleny mezi účastníky projektu, může být fond request přijat a sloučen s hlavní větví projektu. Váš příspěvek bude vložen do projektu a další vývojáři budou moci využít vašich změn.
Proveďte změny a vytvořte fond request - tímto způsobem se můžete aktivně podílet na vývoji projektu na Githubu a sdílet své nápady s ostatními vývojáři.
Vytvořte fond request
1. Přejděte na stránku úložiště, kde chcete vytvořit fond request.
2. Klikněte na kartu "požadavky na Pull" v horní části stránky.
3. Klikněte na zelené tlačítko "New pull request" napravo od Seznamu pool request.
4. Vyberte vlákno se změnami, které chcete přidat do původního úložiště. Můžete si také vybrat větev ze svého forku.
5. Přidejte název a popis do fondu request. Titulek by měl být stručný a popisný, aby ostatní vývojáři pochopili, co bylo změněno.
6. Označte revuery, kteří by měli zhodnotit vaše změny. Revewery mohou být další vývojáři, kteří mohou poskytnout zpětnou vazbu a zkontrolovat váš kód.
7. Po kontrole všech polí klikněte na zelené tlačítko "Create pull request".
8. Váš fond request je nyní vytvořen a viditelný v seznamu pool recvest. Ostatní vývojáři mohou zanechat komentáře a zobrazit vaše změny.
9. Pokud chcete provést změny ve svém fondu request, stačí aktualizovat vlákno se změnami a komentáře se automaticky aktualizují.
10. Pokud jsou vaše změny ověřeny a schváleny, mohou být sloučeny do hlavní větve úložiště.
Nyní víte, jak vytvořit fond request na Githubu a navrhnout vaše změny v projektu. Hodně štěstí!