Skip to content

Latest commit

 

History

History
128 lines (80 loc) · 13.9 KB

README.it.md

File metadata and controls

128 lines (80 loc) · 13.9 KB

Open Source Love License: MIT Open Source Helpers

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.

fork this repository

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

clone this 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.

copy URL to clipboard

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.

create a pull request

Ora invia la pull request.

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

Tutorial usando altri tool

GitHub Desktop Visual Studio 2017 GitKraken VS Code Sourcetree App IntelliJ IDEA
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-retro habitat scikit-learn elasticsearch
exercism Fun Retros react habitat scikit-learn Leiningen numpy elasticsearch
homebrew rust vuejs Suave OpenRA PowerShell coala moment
homebrew Rust vuejs Suave OpenRA PowerShell coala moment
ava freeCodeCamp webpack hoodie pouchdb neovim babel
ava freeCodeCamp webpack hoodie pouchdb neovim babel brackets
Node.js
Node.js Semantic-UI-React