Hacktoberfest è una celebrazione annuale di un mese di progetti, manutentori e contributori open source. L'evento mira a promuovere l'open source e incoraggiare gli sviluppatori a contribuire.
Hacktoberfest prevede incentivi per i primi 40.000 partecipanti che ricevono quattro richieste pull unite entro il 31 ottobre. Puoi far piantare un albero a tuo nome o una maglietta dell'Hacktoberfest.
Tutto inizia con la tua prima richiesta pull/merge.
Registrazione per Hacktoberfest
Per partecipare all'Hacktoberfest, devi prima registrarti all'evento su www.hacktoberfest.com.
Vedrai una schermata simile a questa:
Devi avere un account GitHub o GitLab per partecipare.
Scegli il tuo servizio di hosting preferito e fai clic su INIZIATO pulsante. Facendo clic su questo pulsante verrai reindirizzato all'applicazione scelta, che ti chiederà di approvare Hacktoberfest.
Autorizzando Hacktoberfest ti registrerai automaticamente all'evento.
Ricerca di progetti a cui contribuire su GitHub e GitLab
Solo i contributi ai progetti open source partecipanti su
GitHub o GitLab conterà per Hacktoberfest. Devi avere un account GitHub o GitLab per partecipare.Git Hub
Per trovare i progetti che partecipano a Hacktoberfest su GitHub:
- Navigare verso github.com.
- Passare alla barra di ricerca su GitHub o premere il tasto barra (/) sulla tastiera.
- Digita "Hacktoberfest" e fai clic su ACCEDERE pulsante.
Seguendo i passaggi precedenti verranno visualizzati diversi risultati, con l'argomento Hacktoberfest in cima. Questo argomento ti fornirà un elenco di repository a cui puoi contribuire, come mostrato nell'immagine qui sotto.
In alternativa, puoi andare direttamente al GitHub Hack toberfest argomento.
GitLab
Per trovare i progetti che partecipano a Hacktoberfest su GitLab:
- Navigare verso gitlab.com.
- Nella home page, seleziona esplorare progetti pubblici.
- Nella pagina Esplora progetti, seleziona esplorare argomenti.
- Nel filtra per ricerca campo, inserisci "Hacktoberfest".
Seguendo i passaggi precedenti verranno visualizzati diversi risultati, con l'argomento Hacktoberfest come primo. Questo argomento ti fornirà un elenco di repository a cui puoi contribuire, come mostrato nell'immagine qui sotto.
In alternativa, puoi andare direttamente al GitLab Hacktoberfest argomento.
Creazione di una richiesta pull (PR) su GitHub
Una richiesta pull (PR) è una proposta fatta da un contributore a un progetto che chiede al manutentore del progetto di rivedere e unire le modifiche proposte al progetto.
Per fare un PR, devi trovare un progetto Hacktoberfest a cui vuoi contribuire. Una volta trovato un progetto, fai clic su forchetta pulsante in alto a destra:
Il fork di un progetto crea una copia del progetto nel tuo account GitHub, consentendoti di apportare modifiche senza influire sul progetto principale. Dopo aver eseguito il fork del progetto, clona il repository dal tuo account e apporta le modifiche al tuo ambiente di sviluppo locale.
Assicurati di leggere le linee guida del contributo del progetto e seguile per aumentare le possibilità della tua richiesta pull.
Dopo aver apportato le modifiche e aggiunto la tua versione biforcuta del repository, eseguire il commit delle modifiche utilizzando Gite inviali a GitHub.
Quando le modifiche si riflettono su GitHub, riceverai un messaggio che ti informa che il tuo fork è "commit" prima del ramo principale, come mostrato nell'immagine qui sotto.
Successivamente, fai clic su contribuire pulsante sul prompt. Facendo clic su questo pulsante verrà richiesto di aprire una richiesta pull, come mostrato nell'immagine seguente.
Quindi, fare clic sul richiesta pull aperta pulsante. Questo ti porterà a una pagina in cui esaminerai le linee guida per il contributo e un titolo e una descrizione per la tua richiesta pull.
Compila i campi richiesti e clicca sul Crea richiesta pull pulsante, come mostrato nell'immagine sottostante.
Hai creato una richiesta pull. Ora, attendi che i manutentori del progetto rivedano e uniscano o rifiutino il tuo contributo.
Creazione di una richiesta di unione su GitLab
Una richiesta di unione è identica a una richiesta pull. L'unica differenza sono i rispettivi nomi.
Per effettuare una richiesta di unione, devi prima trovare un progetto Hacktoberfest a cui vuoi contribuire. Una volta trovato un progetto, fai clic sul pulsante fork nell'angolo in alto a destra:
Il fork di un progetto crea una copia del progetto nel tuo account GitLab, permettendoti di apportare modifiche senza influire sul progetto principale. Dopo aver eseguito il fork del progetto, clona il repository dal tuo account e apporta le modifiche al tuo ambiente di sviluppo locale.
Assicurati di leggere le linee guida del contributo del progetto e seguile per aumentare le possibilità della tua richiesta pull.
Dopo aver apportato le modifiche e aggiunto la versione biforcuta del repository, eseguire il commit delle modifiche e inviarli a GitLab.
Dopo aver inviato le modifiche a GitLab, vai al tuo progetto biforcuto e fai clic Richieste di unione nella barra laterale. Questo farà apparire una schermata che spiega una richiesta di fusione e a Nuova richiesta di unione pulsante. Clicca il Nuova richiesta di unione pulsante, come mostrato nell'immagine sottostante.
Successivamente, dovrai selezionare a fonte E bersaglio ramo. IL fonte branch dovrebbe essere il ramo in cui risiedono le modifiche che si desidera eseguire il commit nel repository principale. IL bersaglio branch dovrebbe essere il repository principale in cui desideri eseguire il commit delle modifiche. Dopo aver selezionato i rami, fare clic su Confronta i rami e continua pulsante, come mostrato nell'immagine sottostante.
Facendo clic sul Confronta i rami e continua Il pulsante ti porterà a una pagina in cui puoi inserire un titolo e una descrizione per la tua richiesta di unione.
Compila i dati richiesti e fai clic su Pulsante Crea richiesta di unione, come mostrato nell'immagine qui sotto.
Facendo clic su questo pulsante viene creata la richiesta di unione. Ora devi aspettare che i manutentori del progetto rivedano e uniscano o chiudano la tua richiesta pull.
Termini e condizioni dell'Hacktoberfest
Tutti i contributi dati ai progetti Hacktoberfest devono rientrare nei limiti di Hacktoberfest e non essere spam. Il mancato rispetto delle regole dell'Hacktoberfest può comportare la squalifica dall'evento.
Hacktoberfest emette un periodo di revisione di sette giorni per le richieste pull/merge che seguono tutte le linee guida. Se il tuo PR è buono, il progetto dovrebbe accettarlo per Hacktoberfest entro quel lasso di tempo.
Buon contributo!
