Hacktoberfest er en årlig månedlang fejring af open source-projekter, vedligeholdere og bidragydere. Arrangementet har til formål at fremme open source og opmuntre udviklere til at bidrage.
Hacktoberfest kommer med incitamenter til de første 40.000 deltagere, der får fire pull-anmodninger slået sammen inden den 31. oktober. Du kan enten få plantet et træ i dit navn eller en Hacktoberfest T-shirt.
Det hele begynder med din første pull/merge-anmodning.
Tilmelding til Hacktoberfest
For at deltage i Hacktoberfest skal du først tilmelde dig arrangementet d hacktoberfest.com.
Du vil se en skærm, der ligner denne:
Du skal have en GitHub- eller GitLab-konto for at deltage.
Vælg din foretrukne hostingtjeneste, og klik på IGANGSÆTTE knap. Ved at klikke på denne knap omdirigeres du til din valgte applikation, som vil bede dig om at godkende Hacktoberfest.
Godkendelse af Hacktoberfest vil automatisk registrere dig til begivenheden.
Find projekter at bidrage til på GitHub & GitLab
Kun bidrag til deltagende open source-projekter på
GitHub eller GitLab vil tælle til Hacktoberfest. Du skal have en GitHub- eller GitLab-konto for at deltage.GitHub
Sådan finder du projekter, der deltager i Hacktoberfest på GitHub:
- Naviger til github.com.
- Naviger til søgelinjen på GitHub eller tryk på skråstreg-tasten (/) på dit tastatur.
- Indtast "Hacktoberfest", og klik på GÅ IND knap.
Hvis du følger ovenstående trin, vises flere resultater, med Hacktoberfest-emnet helt øverst. Dette emne vil give dig en liste over depoter, du kan bidrage til, som vist på billedet nedenfor.
Alternativt kan du gå direkte til GitHub Hacktoberfest emne.
GitLab
Sådan finder du projekter, der deltager i Hacktoberfest på GitLab:
- Naviger til gitlab.com.
- Vælg på hjemmesiden udforske offentlige projekter.
- På siden Udforsk projekter skal du vælge udforske emner.
- I den filtrer efter søgning feltet skal du indtaste "Hacktoberfest".
Hvis du følger ovenstående trin, vises flere resultater, med Hacktoberfest-emnet som det allerførste. Dette emne vil give dig en liste over depoter, du kan bidrage til, som vist på billedet nedenfor.
Alternativt kan du gå direkte til GitLab Hacktoberfest emne.
Oprettelse af en Pull Request (PR) på GitHub
En pull request (PR) er et forslag fremsat af en bidragyder til et projekt, der beder projektets vedligeholder om at gennemgå og flette foreslåede ændringer til projektet.
For at lave en PR skal du finde et Hacktoberfest projekt, du vil bidrage til. Når du har fundet et projekt, skal du klikke på gaffel knap i øverste højre hjørne:
Fordeling af et projekt opretter en kopi af projektet på din GitHub-konto, så du kan foretage ændringer uden at påvirke hovedprojektet. Når du har forgrenet projektet, skal du klone lageret fra din konto og foretage ændringerne på dit lokale udviklingsmiljø.
Sørg for at læse projektets retningslinjer for bidrag og følg dem for at øge chancerne for din pull-anmodning.
Efter at have foretaget ændringerne og tilføjet din splittede version af depotet, begå ændringerne ved hjælp af Git, og skub dem til GitHub.
Når ændringerne afspejler sig på GitHub, vil du få en prompt, der informerer dig om, at din fork er "commits" foran hovedgrenen, som vist på billedet nedenfor.
Klik derefter på bidrage knappen på prompten. Hvis du klikker på denne knap, bliver du bedt om at åbne en pull-anmodning, som vist på billedet nedenfor.
Klik derefter på åben pull anmodning knap. Dette fører dig til en side, hvor du vil gennemgå retningslinjerne for bidrag og en titel og beskrivelse af din pull-anmodning.
Udfyld de påkrævede felter og klik på Opret pull-anmodning knappen, som vist på billedet nedenfor.
Du har oprettet en pull-anmodning. Vent nu på, at projektets vedligeholdere gennemgår og fusionerer eller afviser dit bidrag.
Oprettelse af en fletteanmodning på GitLab
En fletteanmodning er identisk med en pull-anmodning. Den eneste forskel er deres respektive navne.
For at lave en fusionsanmodning skal du først finde et Hacktoberfest-projekt, du vil bidrage til. Når du har fundet et projekt, skal du klikke på gaffelknappen i øverste højre hjørne:
Fordeling af et projekt opretter en kopi af projektet på din GitLab-konto, så du kan foretage ændringer uden at påvirke hovedprojektet. Når du har forgrenet projektet, skal du klone lageret fra din konto og foretage ændringerne på dit lokale udviklingsmiljø.
Sørg for at læse projektets retningslinjer for bidrag og følg dem for at øge chancerne for din pull-anmodning.
Efter at have foretaget ændringerne og tilføjet din forgrenede version af depotet, skal du foretage ændringerne, og skub dem til GitLab.
Når du har skubbet dine ændringer til GitLab, skal du navigere til dit splittede projekt og klikke Flet anmodninger i sidebjælken. Dette vil vise et skærmbillede, der forklarer en fletteanmodning og en Ny anmodning om fletning knap. Klik på Ny anmodning om fletning knappen, som vist på billedet nedenfor.
Dernæst skal du vælge en kilde og mål afdeling. Det kilde filial skal være den filial, hvor de ændringer, du ønsker at forpligte til hovedlageret, findes. Det mål filial skal være det primære lager, hvor du vil foretage dine ændringer. Når du har valgt grenene, skal du klikke på Sammenlign grene og fortsæt knappen, som vist på billedet nedenfor.
Ved at klikke på Sammenlign grene og fortsæt knappen fører dig til en side, hvor du kan indtaste en titel og beskrivelse for din anmodning om fletning.
Udfyld de nødvendige oplysninger og klik på Opret fletteanmodningsknap, som vist på billedet nedenfor.
Ved at klikke på denne knap oprettes din fletteanmodning. Nu skal du vente på, at projektets vedligeholdere gennemgår og fusionerer eller lukker din pull-anmodning.
Vilkår og betingelser for Hacktoberfest
Alle bidrag til Hacktoberfest-projekter skal være inden for Hacktoberfests grænser og må ikke være spam. Hvis reglerne for Hacktoberfest ikke følges, kan det medføre diskvalifikation fra begivenheden.
Hacktoberfest udsteder en gennemgangsperiode på syv dage for pull/merge-anmodninger, der følger alle retningslinjerne. Hvis din PR er god, bør projektet acceptere det til Hacktoberfest inden for den tidsramme.
Glad for at bidrage!