Lo dico da quando l’ho scoperto: Github è la piattaforma se vuoi sviluppare un progetto e condividerlo. Non è solo una piattaforma per sviluppatori. E’ molto di più è una piattaforma per condividere idee, prototipi e progetti. Ecco perchè oggi mi son preso un po’ di tempo per tradurre questo semplice tutorial in italiano che descrive i primi passi per iniziare ad usarlo.

Cosa è Github?

Github è una piattaforma di archiviazione di codice per controllo versione e collaborazione. Ti permette di lavorare assieme agli altri su progetti ovunque.

Questo tutorial ti insegna le cose essenziali per usare Github, come i repository, i branch, i commits e le Pull request. Sarai in grado di creare da solo un repository “Ciao Mondo!” ed imparare il flusso di gestione delle Pull request, un modo molto popolare di creare e revisionare il codice.

Non è richiesto saper programmare.

Per completare questo tutorial, tu hai bisogno di un account Github e un accesso internet. Non hai bisogno di conoscere come programmare, usare la linea di comando o installare GIT (il software per controllare le versioni da riga di comando è integrato in Github).

Trucco: apri questa guida in una pagina del browser separata cosi tu puoi vederla mentre completi i passi del tutorial.

1. Creare un repository

Un repository di solito è usata per organizzare un progetto. I repository possono contenere cartelle e file, immagini, video, fogli di calcolo ed insiemi di dati - ogni cosa che sia necessaria per il tuo progetto. Raccomandiamo di includere sempre un README o un file con informazioni sul progetto. GIthub rende facile crearne uno al momento in cui crei i repository. Ti offre altre opzioni come ad esempio quella di inserire un file di licenza.

Il tuo repository ciao-mondo può essere un posto dove memorizzare idee, risorse o anche condividere e discutere cosa con altri.

Per creare un nuovo repository

• In altro a destra, dopo aver fatto il login, fai click sul + e poi seleziona New Repository.
• Nomina il tuo repository ciao-mondo.
• Scrivi una breve descrizione.
• Seleziona “Initialize this repository with a README”

• Fai click su “Create Repository”

2. Creare un branch

Fare un branch è un modo di lavorare su più versioni di un progetto alla volta.

Per default il tuo repository ha un branch chiamato master che è considerato essere il branch ultimo. Usiamo i branch per sperimentare e fare modifiche prima di inserirle nel branch master.

Quando tu fai un branch rispetto al master, stai copiando, o facendo una foto del master cosi come era in quel momento. Se qualcun’altro fa una modifica al master mentre tu stai lavorando sul tuo branch, tu potresti prelevare i suoi aggiornamenti.

Questo diagramma mostra:

• Il branch master
• Un nuovo branch chiamato feature (perchè noi stiamo facendo “feature work” su questo branch)
• Il percorso che feature fa prima che sia fuso con master

Hai mai salvato diverse versioni di un file? Qualcosa tipo

storia.txt storia-joe-modificata.txt storia-joe-modificata-rivista.txt

I branch facilitano questa cosa nei repository di Github.

Qui, presso Github, i nostri sviluppatori, scrittori e designers usano i branch per tenere traccia delle correzioni dei bug e delle feature separate dal brach di produzione master. Quando una modifica è pronta, la fondono dal loro branch nel master.

Per creare un nuovo branch

• Vai nel tuo nuovo repository ciao-mondo
• Fai click sul menu in altro sopra la lista dei file dove trovi la dicitura: master
• scrivi un nome del branch, per esempio “readme-edits”, nella casella di testo.
• Seleziona la box Create o premi Enter sulla tastiera

Ora hai due branch. master e readme-edits. Essi sembrano proprio lo stesso ma non lo saranno per molto! prossimamente noi aggiungeremo modifiche al nuovo branch.

3. Fai e committa modifiche Bravo! Adesso, tu sei sulla vista del codce per il branch readme-edits, che è una copia della master. Facciamo delle modifiche.

Su Github, le modifiche salvate sono chiamate commits. Ogni commit ha un messaggio associato di commit, che è una descrizione che spiega perchè una particolare modifica è stata fatta. I messaggi di commit tengono traccia della storia delle modifiche, cosi gli altri contributori possono capire cosa hai fatto è perchè.

Fare e committare modifiche

• Fai click sul file README.md.
• Fai click sull’icona della matita in alto a destra della vista dei file per fare una modifica.
• Nell’editor scrivo un po’ di cose su di te.
• Scrivi un messaggio di commit che descrive la tua modifica
• Fai click sul pulsante Commit changes

Queste modifiche saranno fatte al README file solo nel tuo branch readme-edits, cosi che ora questo branch contiente contenuti diversi dal branch master.

4. Aprire una Pull Request

Ottime modifiche! Ora che hai modificato un file in un branch tu puoi aprire una pull request.

Pull request sono il cuore della collaborazione con Github. Quando tu apri una pull request, proponi le tue modifiche e richiedi che qualcuno le riveda e le “tiri” e le fonda nel suo branch. Pull requests mostrano le differenze dei contenuti di entrambi i branch. Le modifiche, aggiunte e le eliminazioni sono mostrate in verde e rosso.

Come fai un commit, puoi aprire una pull request e iniziare una discussione, prima che il codice sia finito.

Usando il sistema di “@” menzioni con Github nel tuo messaggio della pull request, puoi chiedere un feedback da una specifica persona o un team.

Puoi anche aprire pull request nel tuo repository e fonderle da solo. E’ un buon modo di imparare il flusso di gestione prima di lavorare su progetti complessi.

Aprire una Pull Request per una modifica al file README

Fai Click sul tab Pull Request tab, quindi dalla pagina Pull Request, fai click sul bottone verde New pull request.

Seleziona il branch dove hai fatto le modifiche per compararlo con il master.

Guarda le tue modifiche nel diff sulla pagina di Compare, assicurati che sono cosa tu vuoi sottomettere.

Quando sarai soddisfatto delle modifiche, fai click sul grande pulsante “Create Pull Request”

Dai alla tua pull request un titolo e scrivi una breve descirzione delle tue modifiche.

Quando hai scritto il tuo messaggio, fai click su Create pull request!

When you’re done with your message, click Create pull request!

Suggerimento: Tu puoi usare emoji e fare drag and drop di immagini and gifs nei commenti.

5. Fondere una Pull Request

In questo step finale, è tempo di portare le tue modifiche fondendole dal tuo branch readme-edits nel branch di produzione master.

• Fai click sul pulsante verde Merge pull request per fondere le modifiche sul branch master
• Fai click su Confirm merge
• Procedi e cancella il branch, dato che le tue modifiche sono state incorporate, con il pulsante “Delete branch” in viola.

Evviva!

Completando questo tutorial, hai imparato a creare un progetto e fare una pull request su Github!

Qui a cosa ti sarà utile questo tutorial:

• creare un repository opensource
• iniziare e gestire un nuovo branch
• modificare un file e committare le modifiche su Github
• Aprire e Fondere una Pull Request

Dai un’occhiata al tuo profilo Github e tu vedrai un nuovo spazio di contributi!

Per molti altri tutorial su Github consulta questa pagina.