A Hacktoberfest a nyílt forráskódú projektek, karbantartók és közreműködők évente egy hónapig tartó ünnepe. Az esemény célja a nyílt forráskód népszerűsítése és a fejlesztők hozzájárulásának ösztönzése.
A Hacktoberfest ösztönzőket biztosít az első 40 000 résztvevő számára, akik négy lehívási kérelmet kapnak összevonva október 31-ig. Kaphat egy fát a nevedre, vagy egy Hacktoberfest pólót.
Minden az első levonási/egyesítési kérelmével kezdődik.
Regisztráció a Hacktoberfestre
A Hacktoberfesten való részvételhez először regisztrálnia kell az eseményre a következő napon: hacktoberfest.com.
Egy ehhez hasonló képernyőt fog látni:
A részvételhez GitHub- vagy GitLab-fiókkal kell rendelkezned.
Válassza ki a kívánt hosting szolgáltatást, és kattintson a gombra BEAVATOTT gomb. A gombra kattintva átirányítja Önt a kiválasztott alkalmazáshoz, amely a Hacktoberfest jóváhagyását kéri.
A Hacktoberfest engedélyezése automatikusan regisztrálja Önt az eseményre.
Projektek keresése, amelyekhez hozzájárulhat a GitHubon és a GitLabon
Csak a részt vevő nyílt forráskódú projektekhez való hozzájárulás GitHub vagy GitLab számítani fog a Hacktoberfesten. A részvételhez GitHub- vagy GitLab-fiókkal kell rendelkezned.
GitHub
A Hacktoberfesten részt vevő projektek megtalálása a GitHubon:
- Navigáljon ide github.com.
- Navigáljon a GitHubon a keresősávhoz, vagy nyomja meg a perjel billentyűt (/) a billentyűzeten.
- Írja be a „Hacktoberfest” szót, és kattintson a gombra BELÉP gomb.
A fenti lépéseket követve számos eredmény jelenik meg, a Hacktoberfest téma a legfelül. Ez a témakör felsorolja azokat a tárhelyeket, amelyekhez hozzájárulhat, amint az az alábbi képen látható.
Alternatív megoldásként közvetlenül a GitHub Hacktoberfest téma.
GitLab
A Hacktoberfesten részt vevő projektek megtalálása a GitLabon:
- Navigáljon ide gitlab.com.
- A kezdőlapon válassza a lehetőséget fedezze fel a nyilvános projekteket.
- A projektek felfedezése oldalon válassza a lehetőséget témákat fedezzen fel.
- Ban,-ben keresés alapján szűrni mezőbe írja be a „Hacktoberfest” kifejezést.
A fenti lépéseket követve számos eredmény jelenik meg, amelyek közül a Hacktoberfest téma lesz az első. Ez a témakör felsorolja azokat a tárhelyeket, amelyekhez hozzájárulhat, amint az az alábbi képen látható.
Alternatív megoldásként közvetlenül a GitLab Hacktoberfest téma.
Pull Request (PR) létrehozása a GitHubon
A lehívási kérelem (PR) egy projektben közreműködő által tett javaslat, amely arra kéri a projekt fenntartóját, hogy tekintse át és egyesítse a projekt javasolt módosításait.
PR készítéséhez meg kell találnia egy Hacktoberfest projektet, amelyhez hozzájárulni szeretne. Ha talált egy projektet, kattintson a Villa gomb a jobb felső sarokban:
A projekt elágazása létrehozza a projekt másolatát a GitHub-fiókjában, amely lehetővé teszi a módosítások végrehajtását a fő projekt befolyásolása nélkül. A projekt elágazása után klónozza a tárat a fiókjából, és hajtsa végre a módosításokat a helyi fejlesztési környezetben.
Feltétlenül olvassa el a projekt hozzájárulási irányelveit, és kövesse azokat, hogy növelje a kérés esélyét.
A módosítások elvégzése és a lerakat elágazott verziójának hozzáadása után, végre kell hajtani a változtatásokat a Git segítségével, és tolja őket a GitHubba.
Amikor a változások érvényesülnek a GitHubon, értesítést kap arról, hogy a fork a fő ág előtt „commit” történik, ahogy az az alábbi képen látható.
Ezután kattintson a hozzájárul gombot a prompton. Ha erre a gombra kattint, akkor az alábbi képen látható módon meg kell nyitnia egy lehívási kérelmet.
Ezután kattintson a nyitott lehívási kérelem gomb. Ezzel egy oldalra jut, ahol áttekintheti a hozzájárulási irányelveket, valamint a lehívási kérelem címét és leírását.
Töltse ki a szükséges mezőket, és kattintson a gombra Lehívási kérelem létrehozása gombot, ahogy az alábbi képen is látható.
Létrehozott egy lehívási kérelmet. Most várja meg, amíg a projekt karbantartói felülvizsgálják és egyesítik vagy elutasítják hozzájárulását.
Egyesítési kérelem létrehozása a GitLabon
Az egyesítési kérelem megegyezik a lekérési kérelemmel. Az egyetlen különbség a megfelelő nevükben van.
Egyesítési kérelem benyújtásához először meg kell találnia egy Hacktoberfest projektet, amelyhez hozzájárulni szeretne. Ha megtalálta a projektet, kattintson a jobb felső sarokban található villa gombra:
A projekt elágazása létrehozza a projekt másolatát a GitLab-fiókjában, amely lehetővé teszi a módosítások végrehajtását a fő projekt befolyásolása nélkül. A projekt elágazása után klónozza a tárat a fiókjából, és hajtsa végre a módosításokat a helyi fejlesztési környezetben.
Feltétlenül olvassa el a projekt hozzájárulási irányelveit, és kövesse azokat, hogy növelje a kérés esélyét.
A módosítások végrehajtása és a lerakat elágazott verziójának hozzáadása után hagyja jóvá a változtatásokat, és tolja őket a GitLab-ba.
Miután elküldte a módosításokat a GitLabba, navigáljon a forked projekthez, és kattintson a gombra Egyesítési kérelmek az oldalsávban. Ekkor megjelenik egy képernyő, amely elmagyarázza az egyesítési kérelmet, és a Új egyesítési kérelem gomb. Kattints a Új egyesítési kérelem gombot, ahogy az alábbi képen is látható.
Ezután ki kell választania a forrás és cél ág. A forrás Az ágnak az az ágnak kell lennie, ahol a fő tárolóban véglegesíteni kívánt változtatások találhatók. A cél ágnak kell lennie a fő tárhelynek, ahol a változtatásokat véglegesíteni kívánja. Az ágak kiválasztása után kattintson a Hasonlítsa össze az ágakat és folytassa gombot, ahogy az alábbi képen is látható.
Kattintson a Hasonlítsa össze az ágakat és folytassa gomb egy oldalra viszi, ahol megadhatja az egyesítési kérelem címét és leírását.
Töltse ki a szükséges adatokat, és kattintson a gombra Egyesítési kérelem létrehozása gomb, az alábbi képen látható módon.
Erre a gombra kattintva létrehozza az egyesítési kérelmet. Most meg kell várnia, amíg a projekt karbantartói felülvizsgálják és egyesítik vagy lezárják a lehívási kérelmet.
A Hacktoberfest Általános Szerződési Feltételei
A Hacktoberfest projektekhez nyújtott minden hozzájárulásnak a Hacktoberfest keretein belül kell lennie, és nem lehet spam jellegű. A Hacktoberfest szabályainak be nem tartása az eseményből való kizárást vonhatja maga után.
A Hacktoberfest hét napos felülvizsgálati időszakot ad ki az összes irányelvet betartó levonási/egyesítési kérelmekre. Ha a PR jó, a projektnek el kell fogadnia a Hacktoberfestre ezen az időkereten belül.
Boldog közreműködést!