Hacktoberfest är ett årligt, månadslångt firande av projekt med öppen källkod, underhållare och bidragsgivare. Evenemanget syftar till att främja öppen källkod och uppmuntra utvecklare att bidra.
Hacktoberfest kommer med incitament för de första 40 000 deltagarna som får fyra pull-förfrågningar sammanslagna senast den 31 oktober. Du kan antingen få ett träd planterat i ditt namn eller en Hacktoberfest T-shirt.
Allt börjar med din första pull/merge-förfrågan.
Anmälan till Hacktoberfest
För att delta i Hacktoberfest måste du först anmäla dig till evenemanget den hacktoberfest.com.
Du kommer att se en skärm som liknar denna:
Du måste ha ett GitHub- eller GitLab-konto för att delta.
Välj din föredragna värdtjänst och klicka på INLEDA knapp. Genom att klicka på den här knappen omdirigeras du till din valda applikation, som kommer att be dig att godkänna Hacktoberfest.
Att auktorisera Hacktoberfest kommer automatiskt att registrera dig för evenemanget.
Hitta projekt att bidra till på GitHub & GitLab
Endast bidrag till deltagande open source-projekt på GitHub eller GitLab kommer att räknas till Hacktoberfest. Du måste ha ett GitHub- eller GitLab-konto för att delta.
GitHub
Så här hittar du projekt som deltar i Hacktoberfest på GitHub:
- Navigera till github.com.
- Navigera till sökfältet på GitHub eller tryck på snedstreckstangenten (/) på ditt tangentbord.
- Skriv in "Hacktoberfest" och klicka på STIGA PÅ knapp.
Om du följer stegen ovan visas flera resultat, med Hacktoberfest-ämnet högst upp. Detta ämne kommer att ge dig en lista över arkiv du kan bidra till, som visas i bilden nedan.
Alternativt kan du gå direkt till GitHub Hacktoberfest ämne.
GitLab
Så här hittar du projekt som deltar i Hacktoberfest på GitLab:
- Navigera till gitlab.com.
- Välj på startsidan utforska offentliga projekt.
- På sidan utforska projekt väljer du utforska ämnen.
- I den filtrera efter sökning fältet, ange "Hacktoberfest."
Om du följer stegen ovan visas flera resultat, med Hacktoberfest-ämnet som det allra första. Detta ämne kommer att ge dig en lista över arkiv du kan bidra till, som visas i bilden nedan.
Alternativt kan du gå direkt till GitLab Hacktoberfest ämne.
Skapa en Pull Request (PR) på GitHub
En pull request (PR) är ett förslag från en bidragsgivare till ett projekt som ber projektets underhållare att granska och slå samman föreslagna ändringar av projektet.
För att göra en PR måste du hitta ett Hacktoberfest-projekt du vill bidra till. När du har hittat ett projekt klickar du på gaffel knappen i det övre högra hörnet:
Fördelning av ett projekt skapar en kopia av projektet i ditt GitHub-konto, så att du kan göra ändringar utan att påverka huvudprojektet. Efter att ha splittrat projektet, klona arkivet från ditt konto och gör ändringarna i din lokala utvecklingsmiljö.
Var noga med att läsa projektets riktlinjer för bidrag och följ dem för att öka chanserna för din begäran om drag.
Efter att ha gjort ändringarna och lagt till din splittrade version av förvaret, utför ändringarna med Git, och skjut dem till GitHub.
När ändringarna återspeglas på GitHub kommer du att få en prompt som informerar dig om att din gaffel är "commits" före huvudgrenen, som visas i bilden nedan.
Klicka sedan på bidra knappen på prompten. Genom att klicka på den här knappen uppmanas du att öppna en pull-begäran, som visas i bilden nedan.
Klicka sedan på öppen pull-begäran knapp. Detta tar dig till en sida där du kommer att granska bidragsriktlinjerna och en titel och beskrivning för din pull-förfrågan.
Fyll i de obligatoriska fälten och klicka på Skapa pull-förfrågan knappen, som visas i bilden nedan.
Du har skapat en pull-begäran. Vänta nu på att projektets underhållare ska granska och slå samman eller avvisa ditt bidrag.
Skapa en sammanslagningsförfrågan på GitLab
En sammanslagningsbegäran är identisk med en pull-begäran. Den enda skillnaden är deras respektive namn.
För att göra en sammanslagningsförfrågan måste du först hitta ett Hacktoberfest-projekt du vill bidra till. När du har hittat ett projekt klickar du på gaffelknappen i det övre högra hörnet:
Forking ett projekt skapar en kopia av projektet i ditt GitLab-konto, så att du kan göra ändringar utan att påverka huvudprojektet. Efter att ha splittrat projektet, klona arkivet från ditt konto och gör ändringarna i din lokala utvecklingsmiljö.
Var noga med att läsa projektets riktlinjer för bidrag och följ dem för att öka chanserna för din begäran om drag.
Efter att du har gjort ändringarna och lagt till din splittrade version av förvaret, genomför ändringarna och skjuta dem till GitLab.
När du har skickat dina ändringar till GitLab, navigera till ditt delade projekt och klicka Sammanfoga förfrågningar i sidofältet. Detta kommer att visa en skärm som förklarar en sammanslagningsförfrågan och en Ny sammanfogningsförfrågan knapp. Klicka på Ny sammanfogningsförfrågan knappen, som visas i bilden nedan.
Därefter måste du välja en källa och mål gren. De källa gren ska vara grenen där ändringarna du vill commitera till huvudförvaret finns. De mål filial bör vara huvudarkivet där du vill genomföra dina ändringar. När du har valt grenarna klickar du på Jämför grenar och fortsätt knappen, som visas i bilden nedan.
Genom att klicka på Jämför grenar och fortsätt knappen tar dig till en sida där du kan ange en titel och beskrivning för din sammanslagningsförfrågan.
Fyll i de nödvändiga uppgifterna och klicka på Skapa sammanslagningsförfrågan-knapp, som visas i bilden nedan.
Genom att klicka på den här knappen skapas din sammanslagningsförfrågan. Nu måste du vänta på att projektets underhållare ska granska och slå samman eller stänga din pull-förfrågan.
Regler och villkor för Hacktoberfest
Alla bidrag som görs till Hacktoberfest-projekt måste ligga inom Hacktoberfests gränser och inte vara skräppost. Att inte följa reglerna för Hacktoberfest kan leda till diskvalificering från evenemanget.
Hacktoberfest utfärdar en granskningsperiod på sju dagar för pull/merge-förfrågningar som följer alla riktlinjer. Om din PR är bra bör projektet acceptera det för Hacktoberfest inom den tidsramen.
Lycka till med att bidra!
