Hacktoberfest je vsakoletno enomesečno praznovanje odprtokodnih projektov, vzdrževalcev in sodelavcev. Namen dogodka je promocija odprte kode in spodbujanje razvijalcev k prispevanju.

Hacktoberfest prinaša spodbude za prvih 40.000 udeležencev, ki do 31. oktobra prejmejo štiri združene zahteve za vleko. Lahko dobite posajeno drevo v svojem imenu ali majico Hacktoberfesta.

Vse se začne z vašo prvo zahtevo za vlečenje/združevanje.

Prijave na Hacktoberfest

Za udeležbo na Hacktoberfestu se morate najprej prijaviti na dogodek na hacktoberfest.com.

Videli boste zaslon, podoben temu:

Za sodelovanje morate imeti račun GitHub ali GitLab.

Izberite želeno storitev gostovanja in kliknite ZAČETI gumb. S klikom na ta gumb boste preusmerjeni na izbrano aplikacijo, ki vas bo pozvala, da odobrite Hacktoberfest.

Z odobritvijo Hacktoberfesta se boste samodejno prijavili na dogodek.

Iskanje projektov za prispevanje na GitHub & GitLab

Samo prispevki za sodelujoče odprtokodne projekte na GitHub ali GitLab bo štel za Hacktoberfest. Za sodelovanje morate imeti račun GitHub ali GitLab.

GitHub

Za iskanje projektov, ki sodelujejo na Hacktoberfestu, na GitHubu:

  1. Pojdite na github.com.
  2. Pomaknite se do iskalne vrstice na GitHubu ali pritisnite tipko s poševnico (/) na vaši tipkovnici.
  3. Vnesite »Hacktoberfest« in kliknite ENTER gumb.

Po zgornjih korakih bo prikazanih več rezultatov, s temo Hacktoberfest na samem vrhu. Ta tema vam bo dala seznam repozitorijev, v katere lahko prispevate, kot je prikazano na spodnji sliki.

Lahko pa greste neposredno na GitHub Hacktoberfest tema.

GitLab

Za iskanje projektov, ki sodelujejo na Hacktoberfestu, na GitLabu:

  1. Pojdite na gitlab.com.
  2. Na domači strani izberite raziščite javne projekte.
  3. Na strani za raziskovanje projektov izberite raziskati teme.
  4. V filtriraj po iskanju polje vnesite »Hacktoberfest«.

Po zgornjih korakih bo prikazanih več rezultatov, s temo Hacktoberfest kot prvo. Ta tema vam bo dala seznam repozitorijev, v katere lahko prispevate, kot je prikazano na spodnji sliki.

Lahko pa greste neposredno na GitLab Hacktoberfest tema.

Ustvarjanje zahteve za vlečenje (PR) na GitHubu

Zahteva po vleki (PR) je predlog, ki ga poda sodelujoči pri projektu in zahteva od vzdrževalca projekta, da pregleda in združi predlagane spremembe projekta.

Če želite narediti PR, morate najti projekt Hacktoberfesta, h kateremu želite prispevati. Ko najdete projekt, kliknite vilice gumb v zgornjem desnem kotu:

Razcepitev projekta ustvari kopijo projekta v vašem računu GitHub, kar vam omogoča spreminjanje brez vpliva na glavni projekt. Po razcepu projekta klonirajte repozitorij iz svojega računa in naredite spremembe v lokalnem razvojnem okolju.

Bodite prepričani, da preberete smernice za prispevke projekta in jih upoštevate, da povečate možnosti za svojo zahtevo za vleko.

Ko naredite spremembe in dodate svojo razcepljeno različico repozitorija, potrdite spremembe z uporabo Gitin jih potisnite na GitHub.

Ko se spremembe odrazijo na GitHubu, boste prejeli poziv, ki vas obvešča, da je vaša razcepitev »zavezana« pred glavno vejo, kot je prikazano na spodnji sliki.

Nato kliknite prispevati gumb na pozivu. Če kliknete ta gumb, boste pozvani, da odprete zahtevo za vlečenje, kot je prikazano na spodnji sliki.

Nato kliknite na odprta zahteva za vleko gumb. To vas bo pripeljalo do strani, kjer boste pregledali smernice za prispevke ter naslov in opis svoje zahteve za vlečenje.

Izpolnite zahtevana polja in kliknite na Ustvari zahtevo za vleko gumb, kot je prikazano na spodnji sliki.

Ustvarili ste zahtevo za vlečenje. Zdaj počakajte, da vzdrževalci projekta pregledajo in združijo ali zavrnejo vaš prispevek.

Ustvarjanje zahteve za združitev v GitLabu

Zahteva za združitev je enaka zahtevi za vlečenje. Edina razlika so njihova imena.

Če želite podati zahtevo za združitev, morate najprej najti projekt Hacktoberfesta, h kateremu želite prispevati. Ko najdete projekt, kliknite gumb vilic v zgornjem desnem kotu:

Razcepitev projekta ustvari kopijo projekta v vašem računu GitLab, kar vam omogoča spreminjanje brez vpliva na glavni projekt. Po razcepu projekta klonirajte repozitorij iz svojega računa in naredite spremembe v lokalnem razvojnem okolju.

Bodite prepričani, da preberete smernice za prispevke projekta in jih upoštevate, da povečate možnosti za svojo zahtevo za vleko.

Ko naredite spremembe in dodate svojo razcepljeno različico repozitorija, potrdite spremembe in potisnite jih v GitLab.

Ko potisnete svoje spremembe v GitLab, se pomaknite do svojega razcepljenega projekta in kliknite Zahteve za združitev v stranski vrstici. To bo prikazalo zaslon z razlago zahteve za združitev in a Nova zahteva za združitev gumb. Kliknite na Nova zahteva za združitev gumb, kot je prikazano na spodnji sliki.

Nato boste morali izbrati a vir in tarča podružnica. The vir veja mora biti veja, kjer se nahajajo spremembe, ki jih želite objaviti v glavnem repozitoriju. The tarča veja mora biti glavno skladišče, kamor želite objaviti svoje spremembe. Ko izberete poslovalnice, kliknite na Primerjaj veje in nadaljuj gumb, kot je prikazano na spodnji sliki.

S klikom na Primerjaj veje in nadaljuj gumb vas bo preusmeril na stran, kjer lahko vnesete naslov in opis svoje zahteve za združitev.

Izpolnite zahtevane podatke in kliknite Gumb za ustvarjanje zahteve za združitev, kot je prikazano na spodnji sliki.

Če kliknete ta gumb, ustvarite svojo zahtevo za združitev. Zdaj morate počakati, da vzdrževalci projekta pregledajo in združijo ali zaprejo vašo zahtevo za vleko.

Pogoji Hacktoberfesta

Vsi prispevki za projekte Hacktoberfesta morajo biti znotraj meja Hacktoberfesta in ne smejo vsebovati neželene pošte. Neupoštevanje pravil Hacktoberfesta lahko povzroči diskvalifikacijo z dogodka.

Hacktoberfest izda sedemdnevno obdobje pregleda za zahteve po vleki/združitvi, ki upoštevajo vse smernice. Če je vaš PR dober, bi ga moral projekt sprejeti za Hacktoberfest v tem časovnem okviru.

Veselo prispevanje!