Hacktoberfest is een jaarlijkse viering van een maand van open-sourceprojecten, beheerders en bijdragers. Het evenement heeft tot doel open source te promoten en ontwikkelaars aan te moedigen een bijdrage te leveren.
Hacktoberfest komt met incentives voor de eerste 40.000 deelnemers die op 31 oktober vier pull-verzoeken hebben samengevoegd. Je kunt een boom laten planten op jouw naam of een Hacktoberfest T-shirt.
Het begint allemaal met uw eerste pull/merge-verzoek.
Inschrijven voor Hacktoberfest
Om deel te nemen aan Hacktoberfest, moet u zich eerst registreren voor het evenement op hacktoberfest.com.
U ziet een scherm dat er ongeveer zo uitziet:
U moet een GitHub- of GitLab-account hebben om deel te nemen.
Kies de hostingservice van uw voorkeur en klik op de knop INITIEREN knop. Als u op deze knop klikt, wordt u doorgestuurd naar de door u gekozen applicatie, die u zal vragen om Hacktoberfest goed te keuren.
Als u Hacktoberfest autoriseert, wordt u automatisch geregistreerd voor het evenement.
Projecten vinden om aan bij te dragen op GitHub & GitLab
Alleen bijdragen aan deelnemende open-sourceprojecten op GitHub of GitLab telt mee voor Hacktoberfest. U moet een GitHub- of GitLab-account hebben om deel te nemen.
GitHub
Om projecten te vinden die deelnemen aan Hacktoberfest op GitHub:
- Navigeren naar github.com.
- Navigeer naar de zoekbalk op GitHub of druk op de schuine streep (/) op je toetsenbord.
- Typ "Hacktoberfest" en klik op het BINNENKOMEN knop.
Door de bovenstaande stappen te volgen, worden verschillende resultaten weergegeven, met het Hacktoberfest-onderwerp helemaal bovenaan. In dit onderwerp vindt u een lijst met repositories waaraan u kunt bijdragen, zoals weergegeven in de onderstaande afbeelding.
U kunt ook rechtstreeks naar de GitHub Hacktoberfest onderwerp.
GitLab
Om projecten te vinden die deelnemen aan Hacktoberfest op GitLab:
- Navigeren naar gitlab.com.
- Selecteer op de startpagina openbare projecten verkennen.
- Selecteer op de pagina Projecten verkennen onderwerpen verkennen.
- In de filteren op zoekopdracht Voer in het veld 'Hacktoberfest' in.
Door de bovenstaande stappen te volgen, worden verschillende resultaten weergegeven, met het Hacktoberfest-onderwerp als allereerste. In dit onderwerp vindt u een lijst met repositories waaraan u kunt bijdragen, zoals weergegeven in de onderstaande afbeelding.
U kunt ook rechtstreeks naar de GitLab Hacktoberfest onderwerp.
Een Pull Request (PR) maken op GitHub
Een pull-aanvraag (PR) is een voorstel van een bijdrager aan een project waarin de beheerder van het project wordt gevraagd om voorgestelde wijzigingen in het project te bekijken en samen te voegen.
Om een PR te maken, moet je een Hacktoberfest-project vinden waaraan je wilt bijdragen. Zodra u een project heeft gevonden, klikt u op de vork knop in de rechterbovenhoek:
Forking van een project maakt een kopie van het project in uw GitHub-account, zodat u wijzigingen kunt aanbrengen zonder het hoofdproject te beïnvloeden. Na het forken van het project, kloont u de repository vanuit uw account en brengt u de wijzigingen aan in uw lokale ontwikkelomgeving.
Zorg ervoor dat u de richtlijnen voor bijdragen van het project leest en deze volgt om de kans op uw pull-aanvraag te vergroten.
Nadat je de wijzigingen hebt aangebracht en je gevorkte versie van de repository hebt toegevoegd, commit de wijzigingen met behulp van Giten push ze naar GitHub.
Wanneer de wijzigingen worden weergegeven op GitHub, krijg je een prompt die je informeert dat je vork "commits" is vóór de hoofdtak, zoals weergegeven in de onderstaande afbeelding.
Klik vervolgens op de bijdragen knop op de prompt. Als u op deze knop klikt, wordt u gevraagd een pull-aanvraag te openen, zoals weergegeven in de onderstaande afbeelding.
Klik vervolgens op de pull-aanvraag openen knop. Dit brengt u naar een pagina waar u de bijdragerichtlijnen en een titel en beschrijving voor uw pull-verzoek zult bekijken.
Vul de verplichte velden in en klik op de Pull-aanvraag maken knop, zoals weergegeven in de onderstaande afbeelding.
U hebt een pull-aanvraag gemaakt. Wacht nu tot de beheerders van het project uw bijdrage beoordelen en samenvoegen of afwijzen.
Een samenvoegverzoek maken op GitLab
Een samenvoegverzoek is identiek aan een pull-verzoek. Het enige verschil is hun respectieve namen.
Om een samenvoegverzoek in te dienen, moet u eerst een Hacktoberfest-project vinden waaraan u wilt bijdragen. Zodra je een project hebt gevonden, klik je op de vorkknop in de rechterbovenhoek:
Forking van een project maakt een kopie van het project in uw GitLab-account, zodat u wijzigingen kunt aanbrengen zonder het hoofdproject te beïnvloeden. Na het forken van het project, kloont u de repository vanuit uw account en brengt u de wijzigingen aan in uw lokale ontwikkelomgeving.
Zorg ervoor dat u de richtlijnen voor bijdragen van het project leest en deze volgt om de kans op uw pull-aanvraag te vergroten.
Nadat u de wijzigingen hebt aangebracht en uw gevorkte versie van de repository hebt toegevoegd, legt u de wijzigingen vast en push ze naar GitLab.
Nadat je je wijzigingen naar GitLab hebt gepusht, navigeer je naar je gevorkte project en klik je Verzoeken samenvoegen in de zijbalk. Er verschijnt een scherm met uitleg over een samenvoegverzoek en een Nieuw samenvoegverzoek knop. Klik op de Nieuw samenvoegverzoek knop, zoals weergegeven in de onderstaande afbeelding.
Vervolgens moet u een selecteren bron En doel tak. De bron branch zou de branch moeten zijn waar de wijzigingen die je wilt vastleggen naar de hoofdrepository zich bevinden. De doel branch zou de hoofdrepository moeten zijn waar u uw wijzigingen wilt doorvoeren. Klik na het selecteren van de takken op de Vergelijk vestigingen en ga verder knop, zoals weergegeven in de onderstaande afbeelding.
Klikken op de Vergelijk vestigingen en ga verder knop brengt u naar een pagina waar u een titel en beschrijving voor uw samenvoegverzoek kunt invoeren.
Vul de vereiste gegevens in en klik op Knop voor samenvoegverzoek maken, zoals weergegeven in de onderstaande afbeelding.
Als u op deze knop klikt, wordt uw samenvoegverzoek gemaakt. Nu moet u wachten tot de beheerders van het project uw pull-aanvraag hebben beoordeeld en samengevoegd of gesloten.
Algemene voorwaarden Hacktoberfest
Alle bijdragen aan Hacktoberfest-projecten moeten binnen de grenzen van Hacktoberfest vallen en mogen geen spam bevatten. Het niet volgen van de regels van Hacktoberfest kan leiden tot diskwalificatie van het evenement.
Hacktoberfest hanteert een beoordelingsperiode van zeven dagen voor pull/merge-verzoeken die aan alle richtlijnen voldoen. Als je PR goed is, zou het project het binnen dat tijdsbestek moeten accepteren voor Hacktoberfest.
Veel plezier met bijdragen!