Leggilo in altre lingue.
È dura. È sempre difficile fare qualcosa per la prima volta. Specialmente quando si sta contribuendo sbagliare ci mette a disagio. L'Open Source, però, si basa sulla collaborazione e sul lavorare insieme. Per questo vogliamo semplificare il modo in cui i nuovi collaboratori imparano e contribuiscono per la prima volta a progetti Open Source.
Leggere articoli e guardare tutorial può essere utile, ma cosa c'è di meglio che provare a fare effettivamente le cose sul campo? 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 qui sotto. Ti promettiamo che sarà divertente.
Se non hai git sul tuo computer, installalo.
Forka questo repo (abbreviazione di repository, ossia una cartella) cliccando sul bottone Fork in cima alla pagina. Questo creerà una copia di questo repository nel tuo account.
Ora clona questo repo nel tuo computer. Clicca sul pulsante per clonare e poi fai click sull'icona copy URL to clipboard.
Apri il terminale e lancia il seguente comando git:
git clone "url appena copiato"
dove "url appena copiato" (senza le virgolette) è l'url di questo repository (il tuo fork di questo progetto). Leggi i precedenti passaggi 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 del repository first-contributions da GitHub al tuo computer.
Entra nella cartella del repository sul tuo computer (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. Lo scopo di nominare un branch è descrivere le modifiche che andremo ad effettuare, il nome deve essere quindi parlante e non generico per facilitare il team con cui si collabora).
Ora apri il file Contributors.md in un editor, inserisci il tuo nome. Non aggiungere il nome all'inizio o alla fine del file, mettilo nel mezzo. Ora salva il file.
Se vai nella cartella 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
Crea ora un commit che includa le modifiche da te fatte, usando il comando 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 nel tuo repository su GitHub, vedrai il pulsante Compare & pull request. Cliccalo.
Ora invia la Pull Request (abbreviato PR).
Presto incorporerò (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.
Congratulazione! Hai appena completato il flusso stardard forka -> clona -> modifica -> pull request che incontrerai spesso come contributore!
Celebra la tua prima contribuzione e condividilo con i tuoi amici e follower accedendo alla web app.
Potrai unirti al nostro team slack in caso hai bisogno di aiuto o hai delle domande. Unisciti al team.
Ora inizia a contribuire ad altri progetti. Abbiamo compilato un elenco di progetti con problemi tecnici semplici su cui puoi iniziare. Controlla la lista dei progetti nella web app.
 |
 |
 |
 |
 |
 |
|---|---|---|---|---|---|
| GitHub Desktop | Visual Studio 2017 | GitKraken | Visual Studio Code | Atlassian Sourcetree | IntelliJ IDEA |