README.it.md

Il primo contributo

È 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.

Fai il fork di questa repository

Fai il fork di questa repo (abbreviazione di repository, ossia un archivio) cliccando sul bottone fork in cima alla pagina. Questo creerà una copia di questa repository nel tuo account.

Scarica la repository

Ora scarica (clone) questa repo nel tuo computer. Clicca sul pulsante per scaricare 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.

Crea un ramo (Branch)

Entra nella directory della repository (se non lo hai già fatto):

cd first-contributions

Ora crea un ramo (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.)

Fai le modifiche necessarie e crea un commit

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 (Push) le modifiche a GitHub

Invia (push) 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.

Invia i tuoi cambiamenti per una revisione

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.

Prossimi passi

Tutorial usando altri tool

GitHub Desktop	Visual Studio 2017	GitKraken	Visual Studio Code	Atlassian Sourcetree	IntelliJ IDEA

E ora?

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ù

exercism	Fun Retros	react	habitat	scikit-learn	Leiningen	numpy	elasticsearch
homebrew	Rust	vuejs	Suave	OpenRA	PowerShell	coala	moment
ava	freeCodeCamp	webpack	hoodie	pouchdb	neovim	babel	brackets
Node.js	Semantic-UI-React