Risposta rapida: GitHub City segue la base del contribution graph
Un GitHub contribution graph e il calendario di attivita mostrato su un profilo GitHub. Puo includere commit conteggiati, pull request, issue, review e altre attivita idonee. Non e un elenco grezzo di ogni azione Git e non sempre si aggiorna all'istante.
Questo conta per GitHub City, perche una citta 3D puo essere completa solo quanto i dati di attivita disponibili. Se il grafico ufficiale non mostra alcuni commit, anche la citta generata puo apparire vuota, bassa o incoerente.
Il flusso pratico e semplice: controlla il grafico ufficiale, verifica che l'attivita rispetti le regole GitHub, attendi eventuali aggiornamenti e poi usa GitHub City o un altro strumento 3D per presentazione ed esplorazione.
Cosa conta in un GitHub contribution graph?
Le regole ufficiali di GitHub sono specifiche. Questa tabella riassume i controlli piu importanti prima di diagnosticare una visualizzazione 3D.
| Attivita | Quando puo contare | Cosa controllare |
|---|---|---|
| Commits | Un commit puo contare quando e associato al tuo account, usa un'email verificata e arriva su un branch conteggiato in un repository idoneo. | Email del commit, branch default o gh-pages, visibilita del repository e presenza in un fork. |
| Pull requests | Possono contare quando sono aperte in repository idonei e associate al tuo account GitHub. | Account che ha aperto la PR, stato del repository e visibilita della PR. |
| Issues e discussioni | Possono contare quando avvengono in repository idonei e sono legate al tuo account. | Visibilita del repository e comparsa nell'attivita del profilo. |
| Code reviews | Possono contare quando sono collegate a pull request in repository idonei. | PR revisionata, idoneita del repository e account usato. |
| Contributi privati | Possono apparire come quadrati anonimizzati se la visibilita privata e attiva. | Impostazioni del profilo e aspettativa tra dettagli privati o soli conteggi anonimi. |
Perche i commit GitHub non appaiono?
Quando il grafico sembra sbagliato, controlla queste cause in ordine. Risolvono i casi piu comuni prima di accusare uno strumento esterno.
Controlla l'email del commit
GitHub deve poter associare l'email del commit al tuo account. Email aziendale, errore di battitura o indirizzo non verificato possono impedire la visualizzazione.
Controlla branch e repository
Il lavoro di solito deve arrivare su branch conteggiati in repository idonei. Branch non unito, fork o repository non idoneo possono restare fuori.
Rivedi le impostazioni private
Il lavoro privato non mostra tutti i dettagli. Se vuoi che influenzi il grafico verde visibile, controlla la visibilita dei contributi privati.
Attendi l'aggiornamento
L'attivita recente puo richiedere tempo per apparire. Se hai appena fatto push, ricontrolla piu tardi.
Confronta con il profilo ufficiale
Se il profilo ufficiale non mostra il lavoro, GitHub City, GitHub Skyline e altri visualizzatori 3D potrebbero non mostrarlo.
I contributi privati influenzano il grafico verde?
L'attivita in repository privati puo influenzare il contribution graph solo entro le regole di privacy di GitHub. Quando la visibilita e attiva, i visitatori possono vedere che c'e stata attivita, ma non il nome del repository ne dettagli sensibili.
Questa differenza conta nei portfolio. Un grafico denso mostra costanza, ma non prova esattamente quale lavoro privato e stato svolto. Allo stesso modo, un GitHub 3D contribution graph comunica ritmo e densita, non un registro completo.
Regola per portfolio
Attiva la visibilita privata se vuoi che l'attivita conti visivamente, ma spiega il lavoro privato importante separatamente in CV, portfolio o note di progetto.
Come questo incide su GitHub City e sugli strumenti 3D
GitHub City trasforma i pattern di contributo in una scena simile a una citta. Questo rende l'attivita piu facile da presentare, ma evidenzia anche i buchi nei dati. Una settimana attiva mancante puo diventare un quartiere visibilmente piu basso.
Prima di condividere una citta 3D, usa il grafico ufficiale come base. Se il grafico verde e corretto, la vista 3D diventa un forte livello visivo. Se il grafico verde e sbagliato, correggi prima i dati di origine.
Quando usare GitHub City
Quando il contribution graph ufficiale e corretto e vuoi un visual memorabile per profilo o portfolio.
Quando fare troubleshooting
Quando la citta e vuota, manca lavoro recente o i contributi privati non appaiono come previsto.
Migliore fonte per le regole
Usa la documentazione ufficiale GitHub per le regole e questa guida come checklist pratica.
Prossimo passo interno
Apri la homepage di GitHub City per generare la citta 3D quando la base e corretta.
FAQ
Cos'e un GitHub contribution graph?
E il calendario di attivita su un profilo GitHub. Riassume contributi idonei, ma non e un log grezzo di ogni commit o azione.
Perche i miei commit non appaiono su GitHub?
Cause comuni sono email non collegata, branch non conteggiato, comportamento dei fork, visibilita privata, idoneita del repository o ritardo di aggiornamento.
I commit GitHub Classroom appaiono nel grafico?
Possono apparire se rispettano le normali regole GitHub. Fork, repository privati o branch non idonei possono cambiare il risultato.
GitHub City sostituisce il grafico ufficiale?
No. GitHub City e un livello visivo per esplorare e presentare pattern. Il grafico ufficiale resta la fonte migliore per verificare se l'attivita e stata contata.
Un grafico 3D puo mostrare nomi di repository privati?
Non dovrebbe esporre dettagli privati. L'attivita privata puo essere rappresentata solo come conteggio anonimizzato quando le impostazioni lo permettono.