È dura. È sempre difficile fare qualcosa per la prima volta. Specialmente quando si sta collaborando, sbagliare ci mette a disagio. Ma l'open source si basa sulla collaborazione e sul lavorare insieme. Pertanto volevamo 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 questa repo (abbreviazione di repository, ossia una cartella) cliccando sul bottone fork in cima alla pagina. Questo creerà 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 -b
:
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 descrittivo e non generale per facilitare il team con cui si collabora.)
Ora apri il file Contributors.md
in un editor, inserisci il tuo nome. Non aggiungerlo all'inizio o alla fine del file ma in un qualsiasi punto nel mezzo. Ora salva il 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
Crea ora una commit che includa le modifiche da te fatte, 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 modifiche saranno state accettate.
GitHub Desktop | Visual Studio 2017 | GitKraken | Visual Studio Code | Atlassian Sourcetree | IntelliJ IDEA |
Unisciti alla nostra squadra su slack in caso tu abbia bisogno di aiuto o abbia qualche domanda. Proveremo ad aiutarti! Unisciti alla squadra Slack.
Qui sotto puoi trovare delle repo popolari dove cercare problemi semplici da cui partire. Continua nelle repo per imparare di più