39 KiB

Raw Blame History Unescape Escape

Introduzione a GitHub

Ciao, futuro sviluppatore! 👋 Pronto a unirti a milioni di programmatori in tutto il mondo? Sono davvero entusiasta di presentarti GitHub – pensalo come un social network per programmatori, ma invece di condividere foto del tuo pranzo, condividiamo codice e creiamo cose incredibili insieme!

Ecco cosa mi lascia senza parole: ogni app sul tuo telefono, ogni sito web che visiti e la maggior parte degli strumenti che imparerai a usare sono stati creati da team di sviluppatori che collaborano su piattaforme proprio come GitHub. Quell'app musicale che ami? Qualcuno come te ha contribuito a crearla. Quel gioco da cui non riesci a staccarti? Sì, probabilmente è stato sviluppato grazie alla collaborazione su GitHub. E ora TU imparerai come far parte di questa straordinaria comunità!

So che all'inizio potrebbe sembrare tutto un po' complicato – ricordo ancora quando guardavo la mia prima pagina su GitHub pensando "Ma che significa tutto questo?" Ma ecco il punto: ogni singolo sviluppatore ha iniziato esattamente da dove sei tu ora. Alla fine di questa lezione, avrai il tuo repository GitHub personale (pensalo come la tua vetrina di progetti nel cloud) e saprai come salvare il tuo lavoro, condividerlo con gli altri e persino contribuire a progetti utilizzati da milioni di persone.

Faremo questo viaggio insieme, passo dopo passo. Niente fretta, niente pressione – solo tu, io e alcuni strumenti davvero fantastici che stanno per diventare i tuoi nuovi migliori amici!

Sketchnote di Tomomi Imura

Quiz Pre-Lettura

Quiz pre-lettura

Introduzione

Prima di immergerci nelle cose davvero entusiasmanti, prepariamo il tuo computer per un po' di magia con GitHub! Pensalo come organizzare i tuoi materiali artistici prima di creare un capolavoro – avere gli strumenti giusti pronti rende tutto più semplice e molto più divertente.

Ti guiderò personalmente attraverso ogni passaggio di configurazione e ti prometto che non è affatto intimidatorio come potrebbe sembrare a prima vista. Se qualcosa non ti è chiaro subito, è assolutamente normale! Ricordo di aver configurato il mio primo ambiente di sviluppo e di essermi sentito come se stessi cercando di decifrare geroglifici antichi. Ogni singolo sviluppatore è stato esattamente dove sei tu ora, chiedendosi se stava facendo tutto nel modo giusto. Spoiler: se sei qui a imparare, stai già facendo tutto nel modo giusto! 🌟

In questa lezione, vedremo:

come tracciare il lavoro che fai sul tuo computer
come lavorare su progetti con altre persone
come contribuire al software open source

Prerequisiti

Prepariamo il tuo computer per un po' di magia con GitHub! Non preoccuparti – questa configurazione è qualcosa che devi fare solo una volta, e poi sarai pronto per tutto il tuo viaggio nel mondo della programmazione.

Bene, iniziamo con le basi! Per prima cosa, dobbiamo verificare se Git è già installato sul tuo computer. Git è praticamente come avere un assistente super intelligente che ricorda ogni singola modifica che fai al tuo codice – molto meglio che premere freneticamente Ctrl+S ogni due secondi (ci siamo passati tutti!).

Vediamo se Git è già installato digitando questo comando magico nel tuo terminale: git --version

Se Git non è ancora installato, nessun problema! Vai su download Git e scaricalo. Una volta installato, dobbiamo presentarti correttamente a Git:

💡 Prima Configurazione: Questi comandi dicono a Git chi sei. Queste informazioni saranno associate a ogni commit che fai, quindi scegli un nome e un'email che ti senti a tuo agio a condividere pubblicamente.

git config --global user.name "your-name"
git config --global user.email "your-email"

Per verificare se Git è già configurato, puoi digitare:

git config --list

Avrai anche bisogno di un account GitHub, un editor di codice (come Visual Studio Code) e dovrai aprire il tuo terminale (o: prompt dei comandi).

Vai su github.com e crea un account se non lo hai già fatto, oppure accedi e completa il tuo profilo.

💡 Consiglio moderno: Considera di configurare chiavi SSH o di utilizzare GitHub CLI per un'autenticazione più semplice senza password.

✅ GitHub non è l'unico repository di codice al mondo; ce ne sono altri, ma GitHub è il più conosciuto.

Preparazione

Avrai bisogno di una cartella con un progetto di codice sul tuo computer (laptop o PC) e di un repository pubblico su GitHub, che servirà come esempio per imparare a contribuire ai progetti degli altri.

Proteggere il tuo codice

Parliamo un momento di sicurezza – ma non preoccuparti, non ti sommergeremo con cose spaventose! Pensa a queste pratiche di sicurezza come chiudere a chiave la tua macchina o la tua casa. Sono abitudini semplici che diventano naturali e proteggono il tuo lavoro.

Ti mostreremo i modi moderni e sicuri per lavorare con GitHub fin dall'inizio. In questo modo, svilupperai buone abitudini che ti serviranno per tutta la tua carriera di programmatore.

Quando lavori con GitHub, è importante seguire le migliori pratiche di sicurezza:

Area di Sicurezza	Migliore Pratica	Perché è Importante
Autenticazione	Usa chiavi SSH o Token di Accesso Personale	Le password sono meno sicure e stanno per essere eliminate
Autenticazione a Due Fattori	Abilita 2FA sul tuo account GitHub	Aggiunge un ulteriore livello di protezione all'account
Sicurezza del Repository	Non commettere mai informazioni sensibili	Le chiavi API e le password non dovrebbero mai essere nei repository pubblici
Gestione delle Dipendenze	Abilita Dependabot per gli aggiornamenti	Mantiene le tue dipendenze sicure e aggiornate

⚠️ Promemoria Critico di Sicurezza: Non commettere mai chiavi API, password o altre informazioni sensibili in un repository. Usa variabili d'ambiente e file .gitignore per proteggere i dati sensibili.

Configurazione Moderna dell'Autenticazione:

# Generate SSH key (modern ed25519 algorithm)
ssh-keygen -t ed25519 -C "your_email@example.com"

# Set up Git to use SSH
git remote set-url origin git@github.com:username/repository.git

💡 Consiglio Pro: Le chiavi SSH eliminano la necessità di inserire ripetutamente le password e sono più sicure rispetto ai metodi di autenticazione tradizionali.

Gestire il tuo codice come un professionista

Ok, ORA arriva la parte davvero entusiasmante! 🎉 Stiamo per imparare come tracciare e gestire il tuo codice come fanno i professionisti, e onestamente, questa è una delle cose che mi piace di più insegnare perché è davvero una svolta.

Immagina questo: stai scrivendo una storia incredibile e vuoi tenere traccia di ogni bozza, ogni modifica brillante e ogni momento "aspetta, è geniale!" lungo il percorso. Questo è esattamente ciò che Git fa per il tuo codice! È come avere il taccuino più incredibile che viaggia nel tempo e ricorda TUTTO – ogni tasto premuto, ogni modifica, ogni momento "oops, ho rotto tutto" che puoi annullare all'istante.

Sarò sincero – all'inizio potrebbe sembrare un po' travolgente. Quando ho iniziato, pensavo "Perché non posso semplicemente salvare i miei file come al solito?" Ma fidati di me: una volta che capirai Git (e succederà!), avrai uno di quei momenti di illuminazione in cui penserai "Come ho fatto a programmare senza questo?" È come scoprire di poter volare quando hai sempre camminato ovunque!

Supponiamo che tu abbia una cartella localmente con un progetto di codice e vuoi iniziare a tracciare i tuoi progressi usando git - il sistema di controllo delle versioni. Alcuni paragonano l'uso di git a scrivere una lettera d'amore al tuo futuro io. Leggendo i tuoi messaggi di commit giorni, settimane o mesi dopo, sarai in grado di ricordare perché hai preso una decisione, o "annullare" una modifica – cioè, quando scrivi buoni "messaggi di commit".

Compito: Crea il tuo primo repository!

🎯 La tua missione (e sono così entusiasta per te!): Creeremo insieme il tuo primo repository GitHub! Quando avremo finito, avrai il tuo piccolo angolo di internet dove vivrà il tuo codice, e avrai fatto il tuo primo "commit" (nel linguaggio degli sviluppatori, significa salvare il tuo lavoro in modo davvero intelligente).

Questo è davvero un momento speciale – stai per unirti ufficialmente alla comunità globale degli sviluppatori! Ricordo ancora l'emozione di creare il mio primo repository e pensare "Wow, lo sto davvero facendo!"

Facciamo questo viaggio insieme, passo dopo passo. Prenditi il tuo tempo per ogni parte – non c'è premio per chi corre, e ti prometto che ogni singolo passaggio avrà senso. Ricorda, ogni superstar della programmazione che ammiri è stata una volta seduta esattamente dove sei tu, pronta a creare il suo primo repository. Quanto è fantastico?

Guarda il video

Facciamolo insieme:

Crea il tuo repository su GitHub. Vai su GitHub.com e cerca quel pulsante verde brillante New (o il segno + in alto a destra). Cliccaci sopra e seleziona New repository.

Ecco cosa fare:
1. Dai un nome al tuo repository – scegli qualcosa che abbia un significato per te!
2. Aggiungi una descrizione se vuoi (aiuta gli altri a capire di cosa tratta il tuo progetto)
3. Decidi se vuoi che sia pubblico (tutti possono vederlo) o privato (solo per te)
4. Ti consiglio di selezionare la casella per aggiungere un file README – è come la prima pagina del tuo progetto
5. Clicca su Create repository e festeggia – hai appena creato il tuo primo repository! 🎉
Vai alla tua cartella di progetto. Ora apriamo il tuo terminale (non preoccuparti, non è così spaventoso come sembra!). Dobbiamo dire al tuo computer dove si trovano i file del tuo progetto. Digita questo comando:
```
cd [name of your folder]
```
Cosa stiamo facendo qui:
- Stiamo praticamente dicendo "Ehi computer, portami alla mia cartella di progetto"
- È come aprire una cartella specifica sul tuo desktop, ma lo stiamo facendo con comandi testuali
- Sostituisci [name of your folder] con il nome effettivo della tua cartella di progetto
Trasforma la tua cartella in un repository Git. Qui avviene la magia! Digita:
```
git init
```
Ecco cosa è appena successo (cose davvero interessanti!):
- Git ha appena creato una cartella nascosta .git nel tuo progetto – non la vedrai, ma è lì!
- La tua cartella normale è ora un "repository" che può tracciare ogni modifica che fai
- Pensalo come se avessi dato alla tua cartella superpoteri per ricordare tutto
Controlla cosa sta succedendo. Vediamo cosa pensa Git del tuo progetto in questo momento:
```
git status
```
Capire cosa ti sta dicendo Git:

Potresti vedere qualcosa che assomiglia a questo:
```
Changes not staged for commit:
(use "git add <file>..." to update what will be committed)
(use "git restore <file>..." to discard changes in working directory)

     modified:   file.txt
     modified:   file2.txt
```
Non farti prendere dal panico! Ecco cosa significa:
- I file in rosso sono file che hanno modifiche ma non sono ancora pronti per essere salvati
- I file in verde (quando li vedi) sono pronti per essere salvati
- Git è utile e ti dice esattamente cosa puoi fare dopo
💡 Consiglio pro: Il comando git status è il tuo migliore amico! Usalo ogni volta che sei confuso su cosa sta succedendo. È come chiedere a Git "Ehi, qual è la situazione in questo momento?"
Prepara i tuoi file per essere salvati (questo si chiama "staging"):
```
git add .
```
Cosa abbiamo appena fatto:
- Abbiamo detto a Git "Ehi, voglio includere TUTTI i miei file nel prossimo salvataggio"
- Il . è come dire "tutto in questa cartella"
- Ora i tuoi file sono "in staging" e pronti per il prossimo passaggio
Vuoi essere più selettivo? Puoi aggiungere solo file specifici:
```
git add [file or folder name]
```
Perché potresti volerlo fare?
- A volte vuoi salvare modifiche correlate insieme
- Ti aiuta a organizzare il tuo lavoro in blocchi logici
- Rende più facile capire cosa è cambiato e quando
Hai cambiato idea? Nessun problema! Puoi rimuovere i file dallo staging in questo modo:
```
# Unstage everything
git reset

# Unstage just one file
git reset [file name]
```
Non preoccuparti – questo non elimina il tuo lavoro, semplicemente toglie i file dalla "pila pronta per il salvataggio".
Salva il tuo lavoro in modo permanente (fai il tuo primo commit!):
```
git commit -m "first commit"
```
🎉 Congratulazioni! Hai appena fatto il tuo primo commit!

Ecco cosa è appena successo:
- Git ha fatto uno "snapshot" di tutti i file in staging in questo momento preciso
- Il tuo messaggio di commit "first commit" spiega di cosa tratta questo punto di salvataggio
- Git ha dato a questo snapshot un ID unico, così potrai sempre trovarlo in seguito
- Hai ufficialmente iniziato a tracciare la storia del tuo progetto!
💡 Messaggi di commit futuri: Per i tuoi prossimi commit, sii più descrittivo! Invece di "aggiornato roba", prova con "Aggiunto modulo di contatto alla homepage" o "Risolto bug nel menu di navigazione". Il tuo futuro io ti ringrazierà!
Collega il tuo progetto locale a GitHub. Al momento, il tuo progetto esiste solo sul tuo computer. Colleghiamolo al tuo repository GitHub così potrai condividerlo con il mondo!

Per prima cosa, vai alla pagina del tuo repository GitHub e copia l'URL. Poi torna qui e digita:
```
git remote add origin https://github.com/username/repository_name.git
```
(Sostituisci quell'URL con l'URL effettivo del tuo repository!)

Ecco cosa abbiamo appena fatto:
- Abbiamo creato una connessione tra il tuo progetto locale e il tuo repository GitHub
- "Origin" è solo un soprannome per il tuo repository GitHub – è come aggiungere un contatto al tuo telefono
- Ora il tuo Git locale sa dove inviare il tuo codice quando sei pronto a condividerlo
💡 Metodo più semplice: Se hai installato GitHub CLI, puoi fare tutto con un solo comando:
```
gh repo create my-repo --public --push --source=.
```
Invia il tuo codice su GitHub (il grande momento!):
```
git push -u origin main
```
🚀 Ecco fatto! Stai caricando il tuo codice su GitHub!

Cosa sta succedendo:
- I tuoi commit stanno viaggiando dal tuo computer a GitHub
- Il flag -u stabilisce una connessione permanente, rendendo più facili i futuri push
- "main" è il nome del tuo branch principale (come la cartella principale)
- Dopo questo, puoi semplicemente digitare git push per i futuri caricamenti!
💡 Nota veloce: Se il tuo branch si chiama in un altro modo (come "master"), usa quel nome. Puoi verificarlo con git branch --show-current.
Il tuo nuovo ritmo quotidiano di coding (qui diventa coinvolgente!):

Da ora in poi, ogni volta che apporti modifiche al tuo progetto, hai questa semplice routine in tre passaggi:
```
git add .
git commit -m "describe what you changed"
git push
```
Questo diventa il battito del tuo coding:
- Fai delle modifiche fantastiche al tuo codice ✨
- Metti in stage con git add ("Ehi Git, presta attenzione a queste modifiche!")
- Salvale con git commit e un messaggio descrittivo (il te del futuro ti ringrazierà!)
- Condividile con il mondo usando git push 🚀
- Ripeti – seriamente, diventa naturale come respirare!
Amo questo workflow perché è come avere più punti di salvataggio in un videogioco. Hai fatto una modifica che ti piace? Commit! Vuoi provare qualcosa di rischioso? Nessun problema – puoi sempre tornare al tuo ultimo commit se le cose vanno storte!

💡 Consiglio: Potresti anche voler adottare un file .gitignore per evitare che file che non vuoi tracciare compaiano su GitHub - come quel file di appunti che conservi nella stessa cartella ma che non ha posto in un repository pubblico. Puoi trovare modelli per i file .gitignore su .gitignore templates o crearne uno usando gitignore.io.

Workflow Git moderni

Considera di adottare queste pratiche moderne:

Conventional Commits: Usa un formato standardizzato per i messaggi di commit come feat:, fix:, docs:, ecc. Scopri di più su conventionalcommits.org
Commit atomici: Fai in modo che ogni commit rappresenti una singola modifica logica
Commit frequenti: Effettua commit frequenti con messaggi descrittivi piuttosto che commit grandi e poco frequenti

Messaggi di commit

Un ottimo messaggio di commit completa la seguente frase: Se applicato, questo commit

Per il soggetto usa l'imperativo, tempo presente: "modifica" non "modificato" né "modifiche". Come nel soggetto, anche nel corpo (opzionale) usa l'imperativo, tempo presente. Il corpo dovrebbe includere la motivazione del cambiamento e confrontarlo con il comportamento precedente. Stai spiegando il perché, non il come.

✅ Prenditi qualche minuto per navigare su GitHub. Riesci a trovare un messaggio di commit davvero ottimo? Riesci a trovarne uno molto minimale? Quali informazioni pensi siano le più importanti e utili da trasmettere in un messaggio di commit?

Collaborare con gli altri (La parte divertente!)

Preparati perché QUI è dove GitHub diventa assolutamente magico! 🪄 Hai imparato a gestire il tuo codice, ma ora stiamo entrando nella mia parte preferita – collaborare con persone straordinarie da tutto il mondo.

Immagina questo: ti svegli domani e scopri che qualcuno a Tokyo ha migliorato il tuo codice mentre dormivi. Poi qualcuno a Berlino risolve un bug su cui ti sei bloccato. Nel pomeriggio, uno sviluppatore a São Paulo ha aggiunto una funzionalità a cui non avevi nemmeno pensato. Non è fantascienza – è solo un martedì nell'universo di GitHub!

Quello che mi entusiasma davvero è che le competenze di collaborazione che stai per imparare? Sono ESATTAMENTE gli stessi workflow che i team di Google, Microsoft e delle tue startup preferite usano ogni singolo giorno. Non stai solo imparando uno strumento interessante – stai imparando il linguaggio segreto che fa funzionare insieme l'intero mondo del software.

Seriamente, una volta che sperimenti l'emozione di vedere qualcuno unire la tua prima pull request, capirai perché gli sviluppatori sono così appassionati di open source. È come far parte del più grande e creativo progetto di squadra del mondo!

Guarda il video

Il motivo principale per mettere le cose su GitHub era rendere possibile collaborare con altri sviluppatori.

Nel tuo repository, vai su Insights > Community per vedere come il tuo progetto si confronta con gli standard della comunità raccomandati.

Vuoi far sembrare il tuo repository professionale e accogliente? Vai al tuo repository e clicca su Insights > Community. Questa funzione interessante ti mostra come il tuo progetto si confronta con ciò che la comunità di GitHub considera "buone pratiche per i repository".

🎯 Fai brillare il tuo progetto: Un repository ben organizzato con una buona documentazione è come avere una vetrina pulita e accogliente. Dice alle persone che tieni al tuo lavoro e le invoglia a contribuire!

Ecco cosa rende un repository fantastico:

Cosa aggiungere	Perché è importante	Cosa fa per te
Descrizione	La prima impressione conta!	Le persone capiscono subito di cosa tratta il tuo progetto
README	La pagina principale del tuo progetto	Come una guida amichevole per i nuovi visitatori
Linee guida per i contributi	Mostra che accetti aiuto	Le persone sanno esattamente come possono aiutarti
Codice di condotta	Crea uno spazio amichevole	Tutti si sentono benvenuti a partecipare
Licenza	Chiarezza legale	Gli altri sanno come possono usare il tuo codice
Politica di sicurezza	Mostra che sei responsabile	Dimostra pratiche professionali

💡 Consiglio Pro: GitHub fornisce modelli per tutti questi file. Quando crei un nuovo repository, seleziona le caselle per generare automaticamente questi file.

Funzionalità moderne di GitHub da esplorare:

🤖 Automazione & CI/CD:

GitHub Actions per test e distribuzione automatizzati
Dependabot per aggiornamenti automatici delle dipendenze

💬 Gestione della comunità e dei progetti:

GitHub Discussions per conversazioni comunitarie oltre ai problemi
GitHub Projects per la gestione dei progetti in stile kanban
Regole di protezione dei branch per garantire standard di qualità del codice

Tutte queste risorse saranno utili per integrare nuovi membri del team. E sono tipicamente il tipo di cose che i nuovi collaboratori guardano prima ancora di esaminare il tuo codice, per capire se il tuo progetto è il posto giusto dove spendere il loro tempo.

✅ I file README, anche se richiedono tempo per essere preparati, sono spesso trascurati dai manutentori impegnati. Riesci a trovare un esempio di uno particolarmente descrittivo? Nota: ci sono alcuni strumenti per aiutarti a creare buoni README che potresti voler provare.

Compito: Unire del codice

I documenti di contributo aiutano le persone a contribuire al progetto. Spiegano quali tipi di contributi stai cercando e come funziona il processo. I collaboratori dovranno seguire una serie di passaggi per poter contribuire al tuo repository su GitHub:

Fare un fork del tuo repository Probabilmente vorrai che le persone facciano un fork del tuo progetto. Fare un fork significa creare una replica del tuo repository sul loro profilo GitHub.
Clonare. Da lì cloneranno il progetto sulla loro macchina locale.
Creare un branch. Vorrai chiedere loro di creare un branch per il loro lavoro.
Concentrarsi su un'area specifica. Chiedi ai collaboratori di concentrarsi su un contributo alla volta - in questo modo le possibilità che tu possa unire il loro lavoro sono più alte. Immagina che scrivano una correzione di bug, aggiungano una nuova funzionalità e aggiornino diversi test - cosa succede se vuoi, o puoi, implementare solo 2 su 3, o 1 su 3 modifiche?

✅ Immagina una situazione in cui i branch sono particolarmente critici per scrivere e distribuire buon codice. Quali casi d'uso ti vengono in mente?

Nota, sii il cambiamento che vuoi vedere nel mondo e crea branch anche per il tuo lavoro. Qualsiasi commit che fai sarà fatto sul branch su cui sei attualmente "checkout". Usa git status per vedere quale branch è.

Passiamo attraverso un workflow per i collaboratori. Supponiamo che il collaboratore abbia già fatto fork e clone del repository, quindi ha un repository Git pronto per essere utilizzato sulla sua macchina locale:

Creare un branch. Usa il comando git branch per creare un branch che conterrà le modifiche che intendono contribuire:
```
git branch [branch-name]
```
💡 Approccio moderno: Puoi anche creare e passare al nuovo branch con un solo comando:
```
git switch -c [branch-name]
```
Passare al branch di lavoro. Passa al branch specificato e aggiorna la directory di lavoro con git switch:
```
git switch [branch-name]
```
💡 Nota moderna: git switch è il sostituto moderno di git checkout per cambiare branch. È più chiaro e sicuro per i principianti.
Lavorare. A questo punto puoi aggiungere le tue modifiche. Non dimenticare di comunicarlo a Git con i seguenti comandi:
```
git add .
git commit -m "my changes"
```
⚠️ Qualità del messaggio di commit: Assicurati di dare al tuo commit un buon nome, sia per te che per il manutentore del repository su cui stai lavorando. Sii specifico su ciò che hai modificato!
Unire il tuo lavoro con il branch main. A un certo punto hai finito di lavorare e vuoi unire il tuo lavoro con quello del branch main. Il branch main potrebbe essere cambiato nel frattempo, quindi assicurati di aggiornarlo prima con i seguenti comandi:
```
git switch main
git pull
```
A questo punto vuoi assicurarti che eventuali conflitti, situazioni in cui Git non riesce facilmente a combinare le modifiche, si verifichino nel tuo branch di lavoro. Pertanto, esegui i seguenti comandi:
```
git switch [branch_name]
git merge main
```
Il comando git merge main porterà tutte le modifiche da main nel tuo branch. Si spera che tu possa semplicemente continuare. In caso contrario, VS Code ti dirà dove Git è confuso e tu dovrai modificare i file interessati per indicare quale contenuto è più accurato.

💡 Alternativa moderna: Considera di usare git rebase per una cronologia più pulita:
```
git rebase main
```
Questo riproduce i tuoi commit sopra l'ultimo branch main, creando una cronologia lineare.
Invia il tuo lavoro su GitHub. Inviare il tuo lavoro su GitHub significa due cose. Fare il push del tuo branch sul tuo repository e poi aprire una PR, Pull Request.
```
git push --set-upstream origin [branch-name]
```
Il comando sopra crea il branch sul tuo repository forkato.
Apri una PR. Successivamente, vuoi aprire una PR. Lo fai navigando nel repository forkato su GitHub. Vedrai un'indicazione su GitHub che ti chiede se vuoi creare una nuova PR, clicca su di essa e verrai portato a un'interfaccia dove puoi modificare il titolo del messaggio di commit, fornire una descrizione più adatta. Ora il manutentore del repository che hai forkato vedrà questa PR e incrociamo le dita apprezzerà e unirà la tua PR. Ora sei un collaboratore, evviva :)

💡 Consiglio moderno: Puoi anche creare PR usando GitHub CLI:
```
gh pr create --title "Your PR title" --body "Description of changes"
```
🔧 Best practices per le PR:
- Collega i problemi correlati usando parole chiave come "Fixes #123"
- Aggiungi screenshot per le modifiche all'interfaccia utente
- Richiedi revisori specifici
- Usa PR in bozza per lavori in corso
- Assicurati che tutti i controlli CI passino prima di richiedere la revisione
Pulizia. È considerata una buona pratica pulire dopo aver unito con successo una PR. Vuoi pulire sia il tuo branch locale che il branch che hai pushato su GitHub. Per prima cosa, cancellalo localmente con il seguente comando:
```
git branch -d [branch-name]
```
Assicurati di andare alla pagina GitHub per il repository forkato e rimuovere il branch remoto che hai appena pushato.

Pull request sembra un termine strano perché in realtà vuoi pushare le tue modifiche al progetto. Ma il manutentore (proprietario del progetto) o il team principale deve considerare le tue modifiche prima di unirle al branch "main" del progetto, quindi stai davvero richiedendo una decisione di modifica da parte di un manutentore.

Una pull request è il luogo in cui confrontare e discutere le differenze introdotte in un branch con revisioni, commenti, test integrati e altro. Una buona pull request segue più o meno le stesse regole di un messaggio di commit. Puoi aggiungere un riferimento a un problema nel tracker dei problemi, quando il tuo lavoro ad esempio risolve un problema. Questo viene fatto usando un # seguito dal numero del tuo problema. Ad esempio #97. 🤞Incrociamo le dita che tutti i controlli vadano a buon fine e che il proprietario/i del progetto approvi le tue modifiche nel progetto🤞

Aggiorna il tuo branch locale di lavoro con tutti i nuovi commit dal branch remoto corrispondente su GitHub:

git pull

Contribuire all'Open Source (La tua occasione per fare la differenza!)

Sei pronto per qualcosa che ti lascerà a bocca aperta? 🤯 Parliamo di contribuire ai progetti open source – e mi vengono i brividi solo pensando di condividere questo con te!

Questa è la tua occasione per far parte di qualcosa di veramente straordinario. Immagina di migliorare gli strumenti che milioni di sviluppatori usano ogni giorno o di correggere un bug in un'app che i tuoi amici adorano. Non è solo un sogno – è proprio questo che significa contribuire all'open source!

Ecco cosa mi emoziona ogni volta che ci penso: ogni singolo strumento con cui hai imparato – il tuo editor di codice, i framework che esploreremo, persino il browser che stai usando per leggere questo – è iniziato con qualcuno esattamente come te che ha fatto il suo primo contributo. Quel brillante sviluppatore che ha creato la tua estensione preferita di VS Code? Una volta era un principiante che cliccava su "crea pull request" con le mani tremanti, proprio come stai per fare tu.

E la parte più bella è questa: la comunità open source è come il più grande abbraccio di gruppo di internet. La maggior parte dei progetti cerca attivamente nuovi arrivati e ha problemi etichettati "good first issue" appositamente per persone come te! I manutentori si entusiasmano davvero quando vedono nuovi contributori perché ricordano i loro primi passi.

Non stai solo imparando a programmare qui – ti stai preparando a unirti a una famiglia globale di costruttori che si svegliano ogni giorno pensando "Come possiamo rendere il mondo digitale un po' migliore?" Benvenuto nel club! 🌟

Per prima cosa, troviamo un repository (o repo) su GitHub che ti interessa e al quale vorresti contribuire con una modifica. Vorrai copiarne il contenuto sul tuo computer.

✅ Un buon modo per trovare repository 'adatti ai principianti' è cercare con il tag 'good-first-issue'.

Ci sono diversi modi per copiare il codice. Uno di questi è "clonare" il contenuto del repository, utilizzando HTTPS, SSH o il GitHub CLI (Command Line Interface).

Apri il terminale e clona il repository in questo modo:

# Using HTTPS
git clone https://github.com/ProjectURL

# Using SSH (requires SSH key setup)
git clone git@github.com:username/repository.git

# Using GitHub CLI
gh repo clone username/repository

Per lavorare sul progetto, passa alla cartella corretta: cd ProjectURL

Puoi anche aprire l'intero progetto utilizzando:

GitHub Codespaces - L'ambiente di sviluppo cloud di GitHub con VS Code nel browser
GitHub Desktop - Un'applicazione GUI per le operazioni Git
GitHub.dev - Premi il tasto . su qualsiasi repository GitHub per aprire VS Code nel browser
VS Code con l'estensione GitHub Pull Requests

Infine, puoi scaricare il codice in una cartella compressa.

Alcune cose interessanti su GitHub

Puoi mettere una stella, seguire e/o "forkare" qualsiasi repository pubblico su GitHub. Puoi trovare i tuoi repository con stella nel menu a tendina in alto a destra. È come aggiungere ai segnalibri, ma per il codice.

I progetti hanno un tracker di problemi, per lo più su GitHub nella scheda "Issues" a meno che non sia indicato diversamente, dove le persone discutono dei problemi relativi al progetto. E la scheda Pull Requests è dove le persone discutono e revisionano le modifiche in corso.

I progetti potrebbero anche avere discussioni in forum, mailing list o canali di chat come Slack, Discord o IRC.

🔧 Funzionalità moderne di GitHub:

GitHub Discussions - Forum integrato per conversazioni della comunità
GitHub Sponsors - Supporta finanziariamente i manutentori
Scheda Security - Rapporti sulle vulnerabilità e avvisi di sicurezza
Scheda Actions - Vedi flussi di lavoro automatizzati e pipeline CI/CD
Scheda Insights - Analisi sui contributori, commit e salute del progetto
Scheda Projects - Strumenti di gestione dei progetti integrati di GitHub

✅ Dai un'occhiata al tuo nuovo repository GitHub e prova alcune cose, come modificare le impostazioni, aggiungere informazioni al tuo repository, creare un progetto (come una bacheca Kanban) e configurare GitHub Actions per l'automazione. C'è molto che puoi fare!

🚀 Sfida

Bene, è ora di mettere alla prova i tuoi nuovi superpoteri GitHub! 🚀 Ecco una sfida che farà cliccare tutto nel modo più soddisfacente:

Coinvolgi un amico (o quel familiare che ti chiede sempre cosa stai facendo con tutta questa "roba da computer") e intraprendi insieme un'avventura di coding collaborativo! È qui che accade la vera magia – crea un progetto, lascia che lo forkino, crea alcuni branch e unisci le modifiche come i professionisti che stai diventando.

Non ti mentirò – probabilmente riderai a un certo punto (soprattutto quando entrambi cercherete di modificare la stessa riga), forse vi gratterete la testa per la confusione, ma sicuramente avrete quei fantastici momenti "aha!" che rendono tutto l'apprendimento degno. Inoltre, c'è qualcosa di speciale nel condividere quella prima fusione riuscita con qualcun altro – è come una piccola celebrazione di quanto sei arrivato lontano!

Non hai ancora un compagno di coding? Nessun problema! La comunità GitHub è piena di persone incredibilmente accoglienti che ricordano com'era essere nuovi. Cerca repository con etichette "good first issue" – stanno praticamente dicendo "Ehi principianti, venite a imparare con noi!" Non è fantastico?

Quiz post-lezione

Revisione e continua a imparare

Wow! 🎉 Guarda te – hai appena conquistato le basi di GitHub come un vero campione! Se la tua mente si sente un po' piena in questo momento, è completamente normale e, onestamente, un buon segno. Hai appena imparato strumenti che mi hanno richiesto settimane per sentirmi a mio agio quando ho iniziato.

Git e GitHub sono incredibilmente potenti (davvero potenti), e ogni sviluppatore che conosco – inclusi quelli che ora sembrano maghi – ha dovuto praticare e inciampare un po' prima che tutto facesse clic. Il fatto che tu abbia superato questa lezione significa che sei già sulla strada per padroneggiare alcuni degli strumenti più importanti nel kit di uno sviluppatore.

Ecco alcune risorse assolutamente fantastiche per aiutarti a praticare e diventare ancora più bravo:

Guida al contributo al software open source – La tua mappa per fare la differenza
Cheatsheet di Git – Tienilo a portata di mano per un rapido riferimento!

E ricorda: la pratica porta al progresso, non alla perfezione! Più usi Git e GitHub, più diventa naturale. GitHub ha creato alcuni corsi interattivi straordinari che ti permettono di praticare in un ambiente sicuro:

Ti senti avventuroso? Dai un'occhiata a questi strumenti moderni:

Documentazione GitHub CLI – Per quando vuoi sentirti un mago della riga di comando
Documentazione GitHub Codespaces – Codifica nel cloud!
Documentazione GitHub Actions – Automatizza tutto
Best practices di Git – Migliora il tuo flusso di lavoro

Sfida GitHub Copilot Agent 🚀

Usa la modalità Agent per completare la seguente sfida:

Descrizione: Crea un progetto collaborativo di sviluppo web che dimostri il completo workflow GitHub che hai imparato in questa lezione. Questa sfida ti aiuterà a praticare la creazione di repository, le funzionalità di collaborazione e i moderni workflow Git in uno scenario reale.

Prompt: Crea un nuovo repository pubblico su GitHub per un semplice progetto "Risorse per lo sviluppo web". Il repository dovrebbe includere un file README.md ben strutturato che elenca strumenti e risorse utili per lo sviluppo web, organizzati per categorie (HTML, CSS, JavaScript, ecc.). Configura il repository con standard di comunità adeguati, inclusi una licenza, linee guida per i contributi e un codice di condotta. Crea almeno due branch di funzionalità: uno per aggiungere risorse CSS e un altro per risorse JavaScript. Fai commit su ciascun branch con messaggi di commit descrittivi, quindi crea pull request per unire le modifiche al branch principale. Abilita funzionalità GitHub come Issues, Discussions e configura un workflow GitHub Actions di base per controlli automatici.

Compito

La tua missione, se decidi di accettarla: Completa il corso Introduzione a GitHub su GitHub Skills. Questo corso interattivo ti permetterà di praticare tutto ciò che hai imparato in un ambiente sicuro e guidato. Inoltre, riceverai un badge fantastico quando lo completerai! 🏅

Ti senti pronto per altre sfide?

Configura l'autenticazione SSH per il tuo account GitHub (niente più password!)
Prova a usare GitHub CLI per le tue operazioni Git quotidiane
Crea un repository con un workflow GitHub Actions
Esplora GitHub Codespaces aprendo proprio questo repository in un editor basato sul cloud

Ricorda: ogni esperto è stato un principiante. Ce la puoi fare! 💪

Disclaimer:
Questo documento è stato tradotto utilizzando il servizio di traduzione AI Co-op Translator. Sebbene ci impegniamo per garantire l'accuratezza, si prega di notare che le traduzioni automatiche possono contenere errori o imprecisioni. Il documento originale nella sua lingua nativa dovrebbe essere considerato la fonte autorevole. Per informazioni critiche, si raccomanda una traduzione professionale umana. Non siamo responsabili per eventuali incomprensioni o interpretazioni errate derivanti dall'uso di questa traduzione.

39 KiB Raw Blame History Unescape Escape