Git 34
🔀 Git & GitHub · Modulo 6 · Lezione 34
Portfolio su GitHub 🌟
Profilo professionale · README del profilo · Repository in evidenza · Contribution graph · Il tuo CV digitale
🌟 Il tuo profilo GitHub è il tuo CV tecnico. Quando un’azienda, un’università o un recruiter cerca il tuo nome, il profilo GitHub è spesso il primo risultato. Non mostra solo cosa sai fare — mostra come lo fai: la qualità del codice, la costanza, la collaborazione. In questa lezione trasformi il tuo profilo da una pagina vuota a un portfolio professionale che ti rappresenta.
🎯 Obiettivi della lezione
- Curare il profilo GitHub come un portfolio professionale
- Creare il README del profilo (il repository speciale)
- Scegliere e mettere in evidenza i repository migliori
- Capire il contribution graph e come renderlo verde
- Preparare i repository del portfolio con README professionali
- Conoscere cosa guardano recruiter e prof nel tuo profilo
📖 1. Teoria
1.1 — Le 5 aree del profilo GitHub
tuousername/tuousername. La “copertina” del tuo profilo.1.2 — Foto, bio e dettagli del profilo
La prima impressione conta. Un profilo curato comunica professionalità; un profilo vuoto comunica disinteresse.
| Elemento | Cosa mettere | Dove modificarlo |
|---|---|---|
| Avatar | Foto professionale o avatar riconoscibile. No foto sfocate, no meme, no immagini di default. | Settings → Profile → Avatar |
| Nome | Il tuo nome reale. I recruiter cercano persone, non nickname. | Settings → Profile → Name |
| Bio | 1-2 frasi: cosa fai e cosa ti interessa. Es: “Studente ITIS 4A · Appassionato di web development e IoT” | Settings → Profile → Bio |
| Location | Città o regione (opzionale ma utile per opportunità locali) | Settings → Profile → Location |
| Website | Link al tuo sito portfolio (magari su GitHub Pages!), LinkedIn, o blog | Settings → Profile → Website |
1.3 — Il README del profilo: il repository speciale
Se crei un repository con lo stesso nome del tuo username (es. mario-rossi/mario-rossi), il suo README.md viene visualizzato nella pagina principale del tuo profilo. È la tua “copertina” — la prima cosa che i visitatori vedono.
mario-rossi).Template per il README del profilo
Studente di informatica all’ITIS, appassionato di web development e IoT.
Mi piace costruire cose che funzionano e imparare ogni giorno qualcosa di nuovo.
## 🔧 Tecnologie
– **Linguaggi:** HTML, CSS, JavaScript, Python
– **Strumenti:** Git, VS Code, Node.js, Docker
– **Interessi:** Web development, IoT, automazione
## 📌 Progetti in evidenza
– 🌐 [**Sito della classe**](link) — Progetto di gruppo con CI/CD su GitHub Pages
– 🤖 [**Bot meteo**](link) — Bot Telegram che invia le previsioni con Python
– 📊 [**Dashboard IoT**](link) — Monitoraggio sensori con Node-RED e Grafana
## 📈 Cosa sto imparando
– React per il frontend
– GitHub Actions per la CI/CD
– Docker per ambienti di sviluppo
## 📫 Contatti
– **Email:** mario.rossi@email.it
– **Portfolio:** [mario-rossi.github.io](https://mario-rossi.github.io)
📌 Mantienilo aggiornato. Il README del profilo non è “scrivi una volta e dimentica” — aggiornalo quando impari una nuova tecnologia, completi un progetto, o cambi interessi. Un profilo aggiornato mostra che sei attivo; uno datato di 2 anni mostra il contrario.
1.4 — Repository in evidenza (pinned)
Puoi “pinnare” fino a 6 repository che appaiono in primo piano nel tuo profilo. Sono la tua vetrina — sceglili con cura.
Descrizione nella pagina del repo
Commit puliti con messaggi chiari
Più di 5 commit (mostra il progresso)
.gitignore appropriato
Nessun file spazzatura committato
Bonus: Pages online / demo link
Nessuna descrizione
1-2 commit con messaggi come “fix” o “update”
node_modules committati
File sensibili (password, .env)
Codice non funzionante
È un fork senza modifiche
1.5 — Il contribution graph: la griglia verde
La griglia di contribuzioni nel profilo mostra quanti commit (e altre attività) hai fatto ogni giorno dell’ultimo anno. Più è verde, più dimostri costanza.
| Attività | Conta? | Condizione |
|---|---|---|
| Commit su main/default branch | ✅ | L’email del commit deve corrispondere all’email GitHub |
| Commit mergiati via PR | ✅ | Il merge di una PR conta come contribuzione |
| Aprire una issue | ✅ | Nel tuo repo o in repo di altri |
| Aprire una PR | ✅ | PR aperta, anche se non ancora mergiata |
| Commit su branch non-default | ❌ | Non contano finché non vengono mergiati in main |
| Commit su fork (senza PR) | ❌ | Non contano — servono i commit nei tuoi repo o PR a repo altrui |
📌 La griglia verde non si “frega”. Non fare commit vuoti solo per riempire la griglia — è un’abitudine tossica e i recruiter esperti lo notano. Piuttosto, lavora regolarmente su progetti reali. Un commit al giorno su un progetto vero è molto più prezioso di 10 commit vuoti.
1.6 — Cosa guardano i recruiter nel tuo profilo
💻 2. Esempi guidati
Esempio A — Creare il README del profilo in 10 minuti
# Su GitHub: New repo → nome: tuousername → ☑ Add README → Create
# 2. Clona e modifica
$ git clone git@github.com:tuousername/tuousername.git
$ cd tuousername
$ code README.md ← incolla il template della sezione 1.3
# 3. Personalizza con le tue info
# Modifica: nome, tecnologie, progetti, contatti
# 4. Committa e pusha
$ git ac “README del profilo con presentazione e progetti”
$ git push
# 5. Vai sul tuo profilo: github.com/tuousername
# Il README appare sotto la bio!
Esempio B — Preparare un repository per il portfolio
🏋️ 3. Esercizi
🟢 Esercizio 1 — Cura il profilo base (Facile)
b) Aggiungi un link (portfolio, LinkedIn o sito su Pages).
c) Visita il tuo profilo come lo vedrebbe un estraneo:
github.com/tuousername.d) Chiedi a un compagno di guardare il tuo profilo: la prima impressione è professionale?
🔵 Esercizio 2 — Crea il README del profilo (Medio)
tuousername/tuousername con README.b) Usa il template della sezione 1.3. Personalizza ogni sezione.
c) Nella sezione “Progetti in evidenza”, linka almeno 2 tuoi repository reali.
d) Committa e pusha. Verifica che il README appaia nel tuo profilo.
e) Chiedi a 2 compagni un feedback: cosa migliorereste?
🟠 Esercizio 3 — Prepara 3 repository per il portfolio (Medio)
b) Per ciascuno, usa la checklist della sezione 1.4: descrizione, README curato, topic, nessun file spazzatura.
c) Se possibile, attiva GitHub Pages su almeno uno di essi.
d) Pinna tutti e 3 nel profilo.
e) Naviga il tuo profilo come un recruiter: in 30 secondi capisci cosa sai fare?
🟣 Esercizio 4 — Portfolio completo con sito personale (Difficile)
a) Profilo: avatar, bio, location, link — tutto compilato.
b) README del profilo: presentazione, tecnologie, progetti, contatti.
c) 6 pinned repositories: ciascuno con README completo, descrizione, topic.
d) Sito portfolio: crea un repository
tuousername.github.io con un sito HTML/CSS che mostra i tuoi progetti. Attiva Pages — il sito è a https://tuousername.github.io.e) Il sito deve avere: chi sei, cosa sai fare, link ai 3 progetti migliori, contatti.
f) Linka il sito nel profilo GitHub e nel README del profilo.
g) Chiedi a prof e compagni di visitare il profilo e il sito. Raccogli feedback.
❓ 4. Quiz di verifica
1. Come si crea il README del profilo GitHub?
Mostra risposta
Crei un repository con lo stesso nome del tuo username (es. se il tuo username è “mario-rossi”, il repo si chiama “mario-rossi”). GitHub riconosce automaticamente che è un repository speciale e mostra il contenuto del suo README.md nella pagina principale del tuo profilo. Il repository deve essere pubblico. GitHub stesso ti avvisa con il messaggio “This is a ✨ special ✨ repository” quando lo crei.
2. Quanti repository puoi pinnare nel profilo?
Mostra risposta
Fino a 6. Si configurano cliccando “Customize your pins” nella pagina del tuo profilo. I repository pinnati sono la tua vetrina — i primi che un visitatore vede. Scegli quelli più completi, con README curati, commit puliti, e possibilmente una demo funzionante. Non pinnare repository vuoti, esperimenti abbandonati o fork a cui non hai contribuito.
3. I commit su un branch non-default contano nella griglia delle contribuzioni?
Mostra risposta
No — non contano finché non vengono mergiati nel branch default (main). La griglia mostra solo commit sul branch default, issue aperte, PR aperte, e review di PR. Anche i commit su fork non contano a meno che non vengano mergiati tramite PR nel repository originale. L’email del commit deve inoltre corrispondere all’email del tuo account GitHub, altrimenti il commit non viene attribuito al tuo profilo.
4. Cosa rende un repository “pronto per il portfolio”?
Mostra risposta
Un README completo e curato (titolo, descrizione, screenshot, istruzioni, tecnologie), una descrizione nella pagina del repo, topic/tag appropriati, commit puliti con messaggi descrittivi (almeno 5+), .gitignore corretto (niente node_modules o file sensibili), e idealmente una demo online (GitHub Pages). Un repository con README vuoto, 1 commit generico e file spazzatura danneggia il portfolio più che aiutarlo — meglio non pinnarlo.
5. Cosa guardano i recruiter nel profilo GitHub di un candidato?
Mostra risposta
In ordine: i pinned repository (primi 6 — sono la prima impressione), la qualità dei README (capacità di comunicazione), la qualità dei commit (messaggi chiari e frequenza regolare), la costanza delle contribuzioni (regolarità nel tempo, non quantità), e le collaborazioni (PR a progetti open source, review, contributi a repo di altri). Non conta avere migliaia di commit — conta avere pochi progetti ben fatti con codice pulito e documentazione chiara.
6. Come si crea un sito portfolio con URL tuousername.github.io?
Mostra risposta
Crei un repository con nome esatto tuousername.github.io (es. mario-rossi.github.io). Aggiungi un file index.html con il tuo sito portfolio. Attiva GitHub Pages (Settings → Pages → Source: main o GitHub Actions). Il sito è automaticamente accessibile a https://tuousername.github.io — senza aggiungere il nome del repo nell’URL. Questo è il tuo “dominio personale” su GitHub — perfetto per un sito portfolio, un blog o una landing page.
📚 Riepilogo della lezione
- 5 aree: avatar/bio · README profilo · pinned repos · contribution graph · lista repos
- README del profilo: repo speciale
tuousername/tuousername→ appare nella pagina profilo - Template: presentazione, tecnologie, progetti in evidenza, cosa sto imparando, contatti
- 6 pinned repos: i migliori, con README curato, descrizione, topic, demo online
- Checklist repo portfolio: README + descrizione + commit puliti + .gitignore + no spazzatura
- Contribution graph: contano commit su main, issue, PR — non commit su branch o fork
- I recruiter guardano: pinned → README → qualità commit → costanza → collaborazioni
- Sito portfolio: repo
tuousername.github.io→ URLhttps://tuousername.github.io
Prossima lezione →
Lezione 35 — Errori comuni e come uscirne
I 10 problemi più frequenti con Git. Panico da terminale.
Comandi di salvataggio. La guida di sopravvivenza dello studente.
Corso Git & GitHub · Per studenti e insegnanti · Lezione 34 di 45