Hello World

Il progetto Hello World è una tradizione antica nella programmazione dei computer. È un semplice esercizio che ti fa iniziare quando impari qualcosa di nuovo. Iniziamo con GitHub!

Imparerai come:

• Creare e usare un repository
• Avviare e gestire un nuovo ramo
• Apportare modifiche a un file e inviarle a GitHub come commit
• Aprire e unire una richiesta di pull

Cos’è GitHub?

GitHub è una piattaforma di hosting del codice per il controllo delle versioni e la collaborazione. Permette a te e ad altri di lavorare insieme su progetti da qualsiasi luogo.

Questo tutorial ti insegna gli elementi essenziali di GitHub come repository, rami, commit e Pull Requests. Creerai il tuo repository Hello World e imparerai il flusso di lavoro Pull Request di GitHub, un modo popolare per creare e rivedere il codice.

Non è necessario codificare

Per completare questo tutorial, hai bisogno di un account GitHub.com e un accesso a Internet. Non è necessario sapere come codificare, usare la linea di comando o installare Git (il software di controllo delle versioni su cui è costruito GitHub).

Tip: Aprite questa guida in una finestra (o scheda) separata del browser in modo da poterla vedere mentre completate i passi del tutorial.

Step 1. Creare un repository

Un repository è solitamente usato per organizzare un singolo progetto. I repository possono contenere cartelle e file, immagini, video, fogli di calcolo e set di dati – qualsiasi cosa di cui il tuo progetto abbia bisogno. Raccomandiamo di includere un README, o un file con informazioni sul tuo progetto. GitHub rende facile aggiungerne uno nello stesso momento in cui crei il tuo nuovo repository. Offre anche altre opzioni comuni come un file di licenza.

Il tuo hello-world repository può essere un luogo dove memorizzare idee, risorse, o anche condividere e discutere con gli altri.

Per creare un nuovo repository

1. Nell’angolo in alto a destra, accanto al tuo avatar o identicon, clicca e poi seleziona New repository.
2. Nomina il tuo repository hello-world.
3. Scrivi una breve descrizione.
4. Seleziona Initialize this repository with a README.

Clicca Create repository.

Step 2. Creare un ramo

Il branching è il modo per lavorare su diverse versioni di un repository in una sola volta.

Di default il tuo repository ha un ramo chiamato main che è considerato il ramo definitivo. Usiamo i rami per sperimentare e fare modifiche prima di inviarle a main.

Quando si crea un ramo dal ramo main, si sta facendo una copia, o snapshot, di main come era in quel momento. Se qualcun altro ha fatto delle modifiche al ramo main mentre si stava lavorando sul proprio ramo, si potrebbero tirare dentro quegli aggiornamenti.

Questo diagramma mostra:

• Il main ramo
• Un nuovo ramo chiamato feature (perché stiamo facendo ‘feature work’ su questo ramo)
• Il viaggio che feature fa prima di essere fuso in main

Hai mai salvato diverse versioni di un file? Qualcosa come:

• story.txt
• story-joe-edit.txt
• story-joe-edit-reviewed.txt

I branch raggiungono obiettivi simili nei repository GitHub.

Qui a GitHub, i nostri sviluppatori, scrittori e designer usano i rami per mantenere le correzioni dei bug e il lavoro sulle funzionalità separate dal nostro main ramo (produzione). Quando un cambiamento è pronto, fondono il loro ramo in main.

Per creare un nuovo ramo

1. Vai al tuo nuovo repository hello-world.
2. Clicca sulla tendina in cima alla lista dei file che dice ramo: main.
3. Digita un nome di ramo, readme-edits, nella casella di testo nuovo ramo.
4. Seleziona la casella blu Crea ramo o premi “Invio” sulla tua tastiera.

Ora avete due rami, main e readme-edits. Sembrano esattamente uguali, ma non per molto! Poi aggiungeremo le nostre modifiche al nuovo ramo.

Passo 3. Fare e commettere le modifiche

Bravo! Ora sei nella vista del codice del tuo ramo readme-edits, che è una copia di main. Facciamo qualche modifica.

Su GitHub, le modifiche salvate sono chiamate commit. Ogni commit ha un messaggio di commit associato, che è una descrizione che spiega perché un particolare cambiamento è stato fatto. I messaggi di commit catturano la storia delle tue modifiche, così gli altri collaboratori possono capire cosa hai fatto e perché.

Fai e commetti le modifiche

1. Clicca sul file README.md.
2. Clicca l’icona della matita nell’angolo in alto a destra della vista del file per modificare.
3. Nell’editor, scrivi qualcosa di te.
4. Scrivi un messaggio di commit che descriva le tue modifiche.
5. Fai clic sul pulsante Commit changes.

Questi cambiamenti saranno fatti solo al file README sul tuo ramo readme-edits, quindi ora questo ramo contiene contenuti diversi da main.

Passo 4. Aprire una richiesta di pull

Belle modifiche! Ora che hai delle modifiche in un ramo di main, puoi aprire una richiesta di pull.

Le richieste di pull sono il cuore della collaborazione su GitHub. Quando apri una richiesta di pull, stai proponendo le tue modifiche e richiedendo che qualcuno riveda e tiri il tuo contributo e lo unisca al suo ramo. Le richieste di pull mostrano i diff, o differenze, del contenuto di entrambi i rami. Le modifiche, aggiunte e sottrazioni sono mostrate in verde e rosso.

Appena fai un commit, puoi aprire una richiesta di pull e iniziare una discussione, anche prima che il codice sia finito.

Utilizzando il sistema @mention di GitHub nel tuo messaggio di richiesta di pull, puoi chiedere un feedback a persone o team specifici, anche se si trovano in fondo al corridoio o a 10 fusi orari di distanza.

Puoi anche aprire richieste di pull nel tuo repository e unirle da solo. È un ottimo modo per imparare il flusso di GitHub prima di lavorare su progetti più grandi.

Apri una richiesta di pull per modifiche al README

Clicca sull’immagine per una versione più grande

Step	Screenshot
Clicca sulla scheda Pull Request, poi dalla pagina della richiesta di pull, fare clic sul pulsante verde Nuova richiesta di pull.
Nella casella Esempio di confronto, selezionate il ramo che avete fatto, readme-edits, da confrontare con main (l’originale).
Guarda le tue modifiche nei diff nella pagina Compare, assicurati che siano quelle che vuoi inviare.
Quando sei soddisfatto che queste sono le modifiche che vuoi inviare, clicca sul grande pulsante verde Create Pull Request.
Dare un titolo alla richiesta di pull e scrivere una breve descrizione delle modifiche.

Quando hai finito il tuo messaggio, clicca su Create pull request!

Suggerimento: Puoi usare emoji e trascinare immagini e gif nei commenti e nelle Pull Requests.

Step 5. Unisci la tua Pull Request

In questo passo finale, è il momento di mettere insieme i tuoi cambiamenti – unendo il tuo readme-edits ramo nel main ramo.

1. Fai clic sul pulsante verde Merge pull request per unire le modifiche in main.
2. Fai clic su Confirm merge.
3. Vai avanti e cancella il ramo, dato che le sue modifiche sono state incorporate, con il pulsante Delete branch nel box viola.

Celebra!

Con il completamento di questo tutorial, hai imparato a creare un progetto e a fare una richiesta di pull su GitHub!

Ecco cosa hai realizzato in questo tutorial:

• Hai creato un repository open source
• Avviato e gestito un nuovo ramo
• Modificato un file e commesso le modifiche su GitHub
• Aperto e unito una Pull Request

Dai un’occhiata al tuo profilo GitHub e vedrai le tue nuove caselle di contributo!