Hacktoberfest er en årlig månedslang feiring av åpen kildekode-prosjekter, vedlikeholdere og bidragsytere. Arrangementet har som mål å fremme åpen kildekode og oppmuntre utviklere til å bidra.
Hacktoberfest kommer med insentiver for de første 40 000 deltakerne som får fire pull-forespørsler slått sammen innen 31. oktober. Du kan enten få plantet et tre i navnet ditt eller en Hacktoberfest T-skjorte.
Det hele begynner med din første pull/merge-forespørsel.
Påmelding til Hacktoberfest
For å delta på Hacktoberfest må du først melde deg på arrangementet på hacktoberfest.com.
Du vil se en skjerm som ligner denne:
Du må ha en GitHub- eller GitLab-konto for å delta.
Velg din foretrukne vertstjeneste og klikk på SETTE I GANG knapp. Ved å klikke på denne knappen omdirigeres du til din valgte applikasjon, som vil be deg om å godkjenne Hacktoberfest.
Autorisering av Hacktoberfest vil automatisk registrere deg for arrangementet.
Finne prosjekter å bidra til på GitHub og GitLab
Kun bidrag til deltakende åpen kildekode-prosjekter på
GitHub eller GitLab vil telle for Hacktoberfest. Du må ha en GitHub- eller GitLab-konto for å delta.GitHub
For å finne prosjekter som deltar i Hacktoberfest på GitHub:
- Navigere til github.com.
- Naviger til søkefeltet på GitHub eller trykk på skråstrek-tasten (/) på tastaturet.
- Skriv inn "Hacktoberfest" og klikk på TAST INN knapp.
Å følge trinnene ovenfor vil vise flere resultater, med Hacktoberfest-emnet helt øverst. Dette emnet vil gi deg en liste over depoter du kan bidra til, som vist på bildet nedenfor.
Alternativt kan du gå direkte til GitHub Hacktoberfest emne.
GitLab
For å finne prosjekter som deltar i Hacktoberfest på GitLab:
- Navigere til gitlab.com.
- Velg på hjemmesiden utforske offentlige prosjekter.
- På siden Utforsk prosjekter velger du utforske emner.
- I filtrer etter søk feltet, skriv inn "Hacktoberfest."
Å følge trinnene ovenfor vil vise flere resultater, med Hacktoberfest-emnet som det aller første. Dette emnet vil gi deg en liste over depoter du kan bidra til, som vist på bildet nedenfor.
Alternativt kan du gå direkte til GitLab Hacktoberfest emne.
Opprette en Pull-forespørsel (PR) på GitHub
En pull request (PR) er et forslag laget av en bidragsyter til et prosjekt som ber prosjektets vedlikeholder om å gjennomgå og slå sammen foreslåtte endringer i prosjektet.
For å lage en PR må du finne et Hacktoberfest-prosjekt du ønsker å bidra til. Når du har funnet et prosjekt, klikker du på gaffel knappen øverst til høyre:
Fordeling av et prosjekt oppretter en kopi av prosjektet i GitHub-kontoen din, slik at du kan gjøre endringer uten å påvirke hovedprosjektet. Etter å ha splittet prosjektet, kloner du depotet fra kontoen din og gjør endringene i ditt lokale utviklingsmiljø.
Sørg for å lese prosjektets retningslinjer for bidrag og følg dem for å øke sjansene for din pull-forespørsel.
Etter å ha gjort endringene og lagt til din forked-versjon av depotet, foreta endringene ved hjelp av Git, og skyv dem til GitHub.
Når endringene gjenspeiles på GitHub, vil du få en melding som informerer deg om at gaffelen din er "forplikter" foran hovedgrenen, som vist på bildet nedenfor.
Deretter klikker du på bidra knappen på ledeteksten. Ved å klikke på denne knappen vil du bli bedt om å åpne en pull-forespørsel, som vist på bildet nedenfor.
Klikk deretter på åpen pull-forespørsel knapp. Dette tar deg til en side der du vil se gjennom retningslinjene for bidrag og en tittel og beskrivelse for pull-forespørselen din.
Fyll ut de nødvendige feltene og klikk på Opprett pull-forespørsel knappen, som vist på bildet nedenfor.
Du har opprettet en pull-forespørsel. Vent nå til prosjektets vedlikeholdere skal vurdere og slå sammen eller avvise bidraget ditt.
Opprette en sammenslåingsforespørsel på GitLab
En sammenslåingsforespørsel er identisk med en pull-forespørsel. Den eneste forskjellen er deres respektive navn.
For å lage en fusjonsforespørsel må du først finne et Hacktoberfest-prosjekt du ønsker å bidra til. Når du har funnet et prosjekt, klikker du på gaffelknappen øverst til høyre:
Fordeling av et prosjekt oppretter en kopi av prosjektet i GitLab-kontoen din, slik at du kan gjøre endringer uten å påvirke hovedprosjektet. Etter å ha splittet prosjektet, kloner du depotet fra kontoen din og gjør endringene i ditt lokale utviklingsmiljø.
Sørg for å lese prosjektets retningslinjer for bidrag og følg dem for å øke sjansene for din pull-forespørsel.
Etter å ha gjort endringene og lagt til den forked-versjonen av depotet, foreta endringene, og push dem til GitLab.
Etter at du har overført endringene til GitLab, naviger til det splittede prosjektet ditt og klikk Slå sammen forespørsler i sidefeltet. Dette vil få opp en skjerm som forklarer en sammenslåingsforespørsel og en Ny sammenslåingsforespørsel knapp. Klikk på Ny sammenslåingsforespørsel knappen, som vist på bildet nedenfor.
Deretter må du velge en kilde og mål gren. De kilde gren skal være grenen der endringene du ønsker å forplikte til hovedlageret ligger. De mål filial bør være hovedlageret der du ønsker å foreta endringene dine. Etter å ha valgt grenene, klikk på Sammenlign grener og fortsett knappen, som vist på bildet nedenfor.
Ved å klikke på Sammenlign grener og fortsett -knappen tar deg til en side der du kan skrive inn en tittel og beskrivelse for sammenslåingsforespørselen.
Fyll ut de nødvendige opplysningene og klikk på Opprett sammenslåingsforespørsel-knapp, som vist på bildet nedenfor.
Ved å klikke på denne knappen opprettes sammenslåingsforespørselen din. Nå må du vente på at prosjektets vedlikeholdere skal gjennomgå og slå sammen eller lukke pull-forespørselen din.
Vilkår og betingelser for Hacktoberfest
Alle bidrag som gis til Hacktoberfest-prosjekter må være innenfor Hacktoberfests grenser og ikke være søppelpost. Å ikke følge reglene for Hacktoberfest kan føre til diskvalifikasjon fra arrangementet.
Hacktoberfest utsteder en syv-dagers vurderingsperiode for pull/merge-forespørsler som følger alle retningslinjene. Hvis PR-en din er god, bør prosjektet akseptere den for Hacktoberfest innen den tidsrammen.
Lykke til med å bidra!