Hacktoberfest je každoročná mesačná oslava open-source projektov, správcov a prispievateľov. Cieľom podujatia je propagovať open source a povzbudiť vývojárov, aby prispievali.
Hacktoberfest prichádza so stimulmi pre prvých 40 000 účastníkov, ktorí dostanú štyri žiadosti o stiahnutie zlúčených do 31. októbra. Môžete si nechať zasadiť strom na svoje meno alebo tričko Hacktoberfest.
Všetko to začína vašou prvou žiadosťou o stiahnutie/zlúčenie.
Registrácia na Hacktoberfest
Ak sa chcete zúčastniť Hacktoberfestu, musíte sa najskôr zaregistrovať na podujatí hacktoberfest.com.
Uvidíte obrazovku podobnú tejto:
Ak sa chcete zúčastniť, musíte mať účet GitHub alebo GitLab.
Vyberte si preferovanú hostingovú službu a kliknite na INICIATOVAŤ tlačidlo. Kliknutím na toto tlačidlo budete presmerovaní na vami zvolenú aplikáciu, ktorá vás požiada o schválenie Hacktoberfestu.
Autorizácia Hacktoberfest vás automaticky zaregistruje na podujatie.
Hľadanie projektov, do ktorých môžete prispieť na GitHub a GitLab
Iba príspevky do participujúcich projektov s otvoreným zdrojom na
GitHub alebo GitLab sa ráta na Hacktoberfest. Ak sa chcete zúčastniť, musíte mať účet GitHub alebo GitLab.GitHub
Ak chcete nájsť projekty zúčastňujúce sa Hacktoberfestu na GitHub:
- Prejdite na github.com.
- Prejdite do vyhľadávacieho panela na GitHub alebo stlačte lomítko (/) na klávesnici.
- Napíšte „Hacktoberfest“ a kliknite na ENTER tlačidlo.
Po vyššie uvedených krokoch sa zobrazí niekoľko výsledkov s témou Hacktoberfest úplne hore. Táto téma vám poskytne zoznam úložísk, do ktorých môžete prispieť, ako je znázornené na obrázku nižšie.
Prípadne môžete prejsť priamo na GitHub Hacktoberfest tému.
GitLab
Ak chcete nájsť projekty zúčastňujúce sa Hacktoberfestu na GitLab:
- Prejdite na gitlab.com.
- Na domovskej stránke vyberte preskúmať verejné projekty.
- Na stránke preskúmať projekty vyberte skúmať témy.
- V filtrovať podľa vyhľadávania zadajte „Hactoberfest“.
Po vykonaní vyššie uvedených krokov sa zobrazí niekoľko výsledkov, pričom téma Hacktoberfest je úplne prvá. Táto téma vám poskytne zoznam úložísk, do ktorých môžete prispieť, ako je znázornené na obrázku nižšie.
Prípadne môžete prejsť priamo na GitLab Hacktoberfest tému.
Vytvorenie Pull Request (PR) na GitHub
Požiadavka na stiahnutie (PR) je návrh vytvorený prispievateľom do projektu, ktorý žiada správcu projektu, aby skontroloval a zlúčil navrhované zmeny do projektu.
Ak chcete urobiť PR, musíte nájsť projekt Hacktoberfest, do ktorého chcete prispieť. Keď nájdete projekt, kliknite na vidlička tlačidlo v pravom hornom rohu:
Rozdelenie projektu vytvorí kópiu projektu vo vašom účte GitHub, čo vám umožní vykonávať zmeny bez ovplyvnenia hlavného projektu. Po rozdelení projektu naklonujte úložisko zo svojho účtu a vykonajte zmeny vo svojom miestnom vývojovom prostredí.
Nezabudnite si prečítať pokyny k príspevku k projektu a dodržiavať ich, aby ste zvýšili šance na vašu žiadosť o stiahnutie.
Po vykonaní zmien a pridaní vašej rozvetvenej verzie úložiska vykonať zmeny pomocou Gita pošlite ich na GitHub.
Keď sa zmeny prejavia na GitHub, dostanete výzvu, ktorá vás informuje, že vaša vidlica je „zaviazaná“ pred hlavnou pobočkou, ako je znázornené na obrázku nižšie.
Ďalej kliknite na prispieť tlačidlo na výzve. Kliknutím na toto tlačidlo sa zobrazí výzva na otvorenie žiadosti o stiahnutie, ako je znázornené na obrázku nižšie.
Potom kliknite na otvorená žiadosť o vytiahnutie tlačidlo. Dostanete sa na stránku, kde si prečítate pokyny pre príspevky a názov a popis vašej žiadosti o stiahnutie.
Vyplňte požadované polia a kliknite na Vytvorte požiadavku na stiahnutie tlačidlo, ako je znázornené na obrázku nižšie.
Vytvorili ste požiadavku na stiahnutie. Teraz počkajte, kým správcovia projektu skontrolujú a zlúčia alebo odmietnu váš príspevok.
Vytvorenie žiadosti o zlúčenie na GitLab
Požiadavka na zlúčenie je identická s požiadavkou na stiahnutie. Jediným rozdielom sú ich príslušné mená.
Ak chcete podať žiadosť o zlúčenie, musíte najprv nájsť projekt Hacktoberfest, do ktorého chcete prispieť. Keď nájdete projekt, kliknite na tlačidlo vidlice v pravom hornom rohu:
Rozdelenie projektu vytvorí kópiu projektu vo vašom účte GitLab, čo vám umožní vykonávať zmeny bez ovplyvnenia hlavného projektu. Po rozdelení projektu naklonujte úložisko zo svojho účtu a vykonajte zmeny vo svojom miestnom vývojovom prostredí.
Nezabudnite si prečítať pokyny k príspevku k projektu a dodržiavať ich, aby ste zvýšili šance na vašu žiadosť o stiahnutie.
Po vykonaní zmien a pridaní vašej rozvetvenej verzie úložiska potvrďte zmeny a presuňte ich do GitLabu.
Po odoslaní zmien do GitLabu prejdite na svoj rozvetvený projekt a kliknite Zlúčiť žiadosti v bočnom paneli. Tým sa zobrazí obrazovka vysvetľujúca žiadosť o zlúčenie a a Nová žiadosť o zlúčenie tlačidlo. Kliknite na Nová žiadosť o zlúčenie tlačidlo, ako je znázornené na obrázku nižšie.
Ďalej budete musieť vybrať a zdroj a cieľ pobočka. The zdroj vetva by mala byť vetva, v ktorej sa nachádzajú zmeny, ktoré chcete odovzdať do hlavného archívu. The cieľ vetva by mala byť hlavným úložiskom, do ktorého chcete uložiť svoje zmeny. Po výbere vetiev kliknite na Porovnajte pobočky a pokračujte tlačidlo, ako je znázornené na obrázku nižšie.
Kliknutím na Porovnajte pobočky a pokračujte sa dostanete na stránku, kde môžete zadať názov a popis vašej žiadosti o zlúčenie.
Vyplňte požadované údaje a kliknite na tlačidlo Vytvoriť žiadosť o zlúčenie, ako je znázornené na obrázku nižšie.
Kliknutím na toto tlačidlo vytvoríte žiadosť o zlúčenie. Teraz musíte počkať, kým správcovia projektu skontrolujú a zlúčia alebo zatvoria vašu požiadavku na stiahnutie.
Podmienky Hacktoberfestu
Všetky príspevky do projektov Hacktoberfestu musia byť v rámci Hacktoberfestu a nesmú byť spamové. Nedodržanie pravidiel Hacktoberfestu môže viesť k diskvalifikácii z podujatia.
Hacktoberfest vydáva sedemdňovú lehotu na kontrolu žiadostí o stiahnutie/zlúčenie, ktoré spĺňajú všetky pokyny. Ak je vaše PR dobré, projekt by ho mal prijať na Hacktoberfest v tomto časovom rámci.
Šťastné prispievanie!