Iniziare

Impara la nostra convenzione di commit

2 min read
292 words

Ci 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:

TipoDescrizione
addAggiungi una nuova funzionalità
fixRisolvi un bug
improveMigliora qualcosa
updateAggiorna qualcosa
removeRimuovi qualcosa
refactorRifattorizza qualcosa
renameRinomina qualcosa
moveSposta un file o una cartella
upgradeAggiorna le dipendenze
downgradeDeclassa 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