Iniziare
Impara la nostra convenzione di commit
2 min read
•292 wordsCi piace avere una cronologia dei progetti pulita. La nostra convenzione per i commit è ispirata da Conventional Commits ma personalizzata con gitmoji per renderla più visiva e divertente.
Struttura
Il messaggio del commit dovrebbe essere strutturato come segue e in minuscolo:
<gitmoji> <tipo> <descrizione> [(#<numero dell'issue>)]
[corpo opzionale]
[footer(e) opzionali]
Esempio
📝 aggiorna i contributori della documentazione
- Aggiungi @jerembdn come contributore
- Aggiungi @younesbessa come contributore
Co-autore: Younes Bessa <[email protected]>
La maggior parte delle volte, una semplice riga è sufficiente:
📝 aggiorna i contributori della documentazione
Tipi
Usiamo i seguenti tipi di commit:
| Tipo | Descrizione |
|---|---|
add | Aggiungi una nuova funzionalità |
fix | Risolvi un bug |
improve | Migliora qualcosa |
update | Aggiorna qualcosa |
remove | Rimuovi qualcosa |
refactor | Rifattorizza qualcosa |
rename | Rinomina qualcosa |
move | Sposta un file o una cartella |
upgrade | Aggiorna le dipendenze |
downgrade | Declassa le dipendenze |
Descrizione
Scrivi le descrizioni in modo imperativo e minuscolo:
# Buono
📝 aggiorna i contributori della documentazione
# Cattivo
📝 aggiornato i contributori della documentazione
# Cattivo
📝 Aggiorna i contributori della documentazione
Numero dell'Issue
Collega i commit alle issue aggiungendo il numero dell'issue:
📝 aggiorna i contributori della documentazione (#123)
Corpo
Usa il corpo per contesto e motivazione:
📝 aggiorna i contributori della documentazione
- Aggiungi @jerembdn come contributore
- Aggiungi @younesbessa come contributore
Co-autore: Younes Bessa <[email protected]>
Un Commit, Un Obiettivo
Ogni commit dovrebbe rappresentare un singolo cambiamento logico. Non mescolare cambiamenti non correlate.
Last updated on 01/14/2026