Introduzione
In questo tutorial spiegheremo come eseguire il fork di un repository, apportare modifiche e chiedere ai manutentori di revisionarlo e unirlo al branch principale.
Contribuire ad un progetto
Quando si desidera lavorare su un progetto GitHub, il primo passo creare un fork del repository che vi interessa.
Entra nella pagina principale del repository, fai clic sul pulsante Fork nell'angolo in alto a destra.
Questo crearà una nuova copia del repository nel tuo account utente di GitHub con un URL simile a questo:
https://github.com/nome_utente/nome_repository
La copia include tutto il codice, i rami e i commit dal repository originale.
Quindi, clona il repository aprendo il terminale sul computer ed eseguendo questo comando, modificando nome utente e nome del repository:
git clone https://github.com/nome_utente/nome_repository
Una volta clonato il repository, crea un nuovo branch con il seguente comando:
git checkout -b new_branch
Crea un nuovo collegamento con il repository upstream (repository originale da cui è stato creato il fork), con il seguente comando:
git remote add upstream https://github.com/nome_repository_originale/repository
Ora puoi apportare modifiche al codice.
Dopo aver apportato le modifiche al tuo repository, quindi dopo aver utilizzato il comando push
, apparirà su Github il pulsante Compare & pull request nella pagina del repository originale.
Premere il pulsante e si aprirà una nuova schermata Create pull request. Ciò consente ai manutentori del repository di visionare il tuo contributo. Da qui, possono unirlo se è considerato utile o possono chiederti di apportare alcune modifiche.
In Breve, se si desidera contribuire a un progetto, il modo più semplice è:
- Trova un progetto a cui vuoi contribuire
- Crea un Fork
- Clonalo sul tuo sistema locale
- Crea un nuovo Branch
- Apporta le tue modifiche
- Invia le modifiche verso il tuo repository
- Fai clic sul pulsante Compare & pull request
- Fare clic su Create pull request per aprire una nuova richiesta pull
Se i revisori chiedono modifiche, ripetere i passaggi 5 e 6 per aggiungere altri commit alla richiesta pull.
Conclusione
In questo tutorial abbiamo visto come contribuire allo sviluppo di un repository di Github.