È dura. È sempre difficile fare qualcosa per la prima volta. Specialmente quando stai collaborando, sbagliare non è una cosa comoda. Ma l'open source si basa sulla collaborazione e sul lavorare insieme. Lo scopo di questo progetto è quello di semplificare il modo in cui per la prima si impara come contribuire in progetti open-source.
Leggere articoli e guardare tutorial può essere utile, ma cosa c'è di meglio che fare effettivamente le cose, senza sbagliare nulla? Questo progetto punta ad essere una guida per i meno esperti. Ricorda: più sei rilassato meglio imparerai. Se vuoi contribuire per la prima volta, segui i semplici passi elencati sotto. Ti promettiamo che sarà divertente.
Se non hai git sul tuo computer, installalo .
Forka questa repo cliccando sul bottone fork in cima alla pagina. Questo creeerà una copia di questa repository nel tuo account.
Ora clona questa repo nel tuo computer. Clicca sul pulsante per clonare e poi copia l'url.
Apri il terminale e lancia il seguente comando:
git clone "url appena copiato"
dove "url appena copiato" (senza le virgolette) è l'url di questa repository. Leggi i passaggi precedenti per ottenere l'url.
Per esempio:
git clone https://github.com/questo-sei-tu/first-contributions.git
dove questo-sei-tu
è il tuo username GitHub. Qui stai copiando il contenuto della repository da GitHub al tuo computer.
Entra nella directory della repository (se non lo hai già fatto):
cd first-contributions
Ora crea un branch usando il comando git checkout
:
git checkout -b <aggiungi-il-tuo-nome>
Ad esempio:
git checkout -b aggiungi-alonzo-church
(Non è necessario inserire la parola aggiungi nel nome del branch, ma in questo caso è ragionevole includerlo poiché lo scopo di questo branch è aggiungere il tuo nome alla lista.)
Ora apri il file Contributors.md
in un editor, inserisci il tuo nome e salva il the file. Se vai nella directory del progetto ed esegui il comando git status
, vedrai quali sono i cambiamenti. Aggiungi le modifiche al branch appena creato usando il comando git add
:
git add Contributors.md
Ora valida i cambiamenti usando git commit
:
git commit -m "Add <il-tuo-nome> to Contributors list"
cambiando <il-tuo-nome>
con il tuo nome.
Invia le tue modifiche con il comando git push
:
git push origin <aggiungi-il-tuo-nome>
sostituendo <aggiungi-il-tuo-nome>
con il nome del branch creato prima.
Se vai nella tua repository su GitHub, vedrai il pusante Compare & pull request
. Cliccalo.
Ora invia la pull request.
Presto avrò incorporato (merge) tutti i tuoi cambiamenti nel master branch di questo progetto. Ti arriverà una mail di notifica una volta che le modiche saranno state accettate.
GitHub Desktop | Visual Studio 2017 | GitKraken |
Potresti anche unirti alla nostra aquadra su slack in caso tu abbia bisogno di aiuto o abbia qualche domanda. Unisciti alla squadra
Qui sotto puoi trovare delle repo popolari dove cercare issue semplici che potresti risolvere. Continua nelle repo per imparare di più