I messaggi di commit si scrivono per il team, il changelog si scrive per chi usa il software. Generatore di changelog fa il passaggio dall'uno all'altro, prende appunti grezzi come commit, titoli dei ticket o una lista veloce e restituisce una voce pronta per il tuo CHANGELOG.md o per la pagina del rilascio.
Segue la convenzione Keep a Changelog. La voce si apre con un titolo di secondo livello con versione e data, poi raggruppa le modifiche sotto Added, Changed, Deprecated, Removed, Fixed e Security, in quest'ordine e solo se il gruppo ha qualcosa dentro. Ogni modifica diventa una frase breve che inizia con un verbo, i doppioni vengono uniti, il rumore interno come i commit di merge sparisce e le modifiche incompatibili ricevono il prefisso BREAKING.
I numeri dei ticket restano dove li hai scritti e lo strumento non aggiunge mai una modifica che non hai elencato. Fa parte della famiglia Strumenti per sviluppatori. Per spiegare per esteso una nuova funzionalità è più adatto Articolo di documentazione.
Cosa ottieni
- Un titolo di versione nella forma ## [versione] - AAAA-MM-GG, con la data presa dai tuoi appunti oppure il segnaposto [YYYY-MM-DD]
- Le modifiche raggruppate sotto Added, Changed, Deprecated, Removed, Fixed e Security, senza i gruppi vuoti
- Frasi pensate per gli utenti, che iniziano con un verbo, con i doppioni uniti
- Le modifiche incompatibili segnate con il prefisso BREAKING
- I riferimenti ai ticket lasciati al loro posto, così ogni voce resta tracciabile
Cosa compili
- Versione obbligatorio
-
Se puoi, usa il versionamento semantico (major.minor.patch).
- Modifiche di questo rilascio obbligatorio
-
Vanno bene anche appunti grezzi. Aggiungi la data di rilascio se vuoi che compaia.
Come si usa, passo dopo passo
-
Apri Generatore di changelog
Lo trovi nella famiglia Strumenti per sviluppatori. Il modulo chiede due cose, Versione e Modifiche di questo rilascio.
-
Inserisci il numero di versione
Se puoi usa il versionamento semantico, per esempio 2.4.0. Compare nel titolo esattamente come lo scrivi.
-
Incolla le modifiche, una per riga
Commit, titoli dei ticket o appunti veloci vanno tutti bene. Se vuoi la data nel titolo, scrivila in un punto qualsiasi degli appunti.
-
Genera, controlla e incolla
Scegli la lingua di uscita, genera, verifica i raggruppamenti e incolla la voce in cima al tuo changelog.
Esempio, input e risultato
Input
- version
- 2.4.0
- changes
- rilascio 2026-10-15 feat: esportazione fatture in CSV (#412) fix: il calendario mostrava il mese sbagliato su Safari (#398) Merge branch 'main' into dev chore: corretto refuso in un commento rimossi gli endpoint legacy API v1, breaking (#405) feat: tema scuro nella pagina impostazioni
Risultato
### Added
- Aggiunta l'esportazione delle fatture in CSV (#412).
- Aggiunto il tema scuro nella pagina delle impostazioni.
### Removed
- BREAKING Rimossi gli endpoint legacy dell'API v1 (#405).
### Fixed
- Corretto il mese mostrato dal calendario su Safari (#398).
Esempio illustrativo scritto dalla redazione per mostrare il formato atteso.
Consigli per risultati migliori
- Incolla tutto, anche i commit rumorosi. Separare quello che interessa agli utenti è il lavoro dello strumento.
- Scrivi «breaking» accanto a ogni modifica che rompe la compatibilità, così riceve il prefisso BREAKING.
- Metti la data di rilascio negli appunti nel formato AAAA-MM-GG, per esempio 2026-10-15, ed eviti il segnaposto nel titolo.
- Lascia i numeri dei ticket negli appunti, rendono ogni voce verificabile.
Chi lo usa, e per cosa
Manutentori di progetti open source
Trasforma i commit dall'ultimo tag in una voce per CHANGELOG.md e per il rilascio sulla piattaforma che ospita il codice.
Team di prodotto SaaS
Scrivi note di rilascio comprensibili agli utenti partendo dai ticket chiusi nello sprint.
Sviluppatori di plugin e temi
Prepara la sezione changelog che marketplace e utenti si aspettano a ogni aggiornamento.
Agenzie e software house che consegnano ai clienti
Invia un elenco chiaro di cosa è cambiato in una consegna, scritto per chi non è tecnico.
Limiti e buone pratiche
- Scrive una voce per generazione, per una sola versione. Non unisce la storia completa di un progetto.
- Conosce solo gli appunti che incolli, quindi una modifica assente dagli appunti è assente anche dal changelog.
- I titoli dei gruppi e il prefisso BREAKING restano in inglese, come prevede la convenzione, anche quando le voci sono in italiano.
- Ogni generazione usa i crediti del tuo piano, vedi i prezzi o crea un account.
Domande frequenti
Cos'è il formato Keep a Changelog?
È una convenzione molto diffusa per changelog leggibili dalle persone. Ogni versione ha un titolo con numero e data e le modifiche sono raggruppate sotto Added, Changed, Deprecated, Removed, Fixed e Security, con la versione più recente in cima. Generatore di changelog segue questa struttura per ogni voce.
Posso incollare i messaggi di commit così come sono?
Sì. Incollali uno per riga, compresi i prefissi convenzionali come feat o fix. Lo strumento riscrive ognuno in una frase breve per gli utenti, unisce i doppioni e scarta il rumore interno, come i commit di merge o i refusi corretti nei commenti, a meno che non riguardino gli utenti.
Come vengono mostrate le modifiche incompatibili?
Ogni modifica che negli appunti descrivi come incompatibile riceve il prefisso BREAKING, così chi aggiorna non può perderla. Per sicurezza scrivi la parola «breaking» accanto a ciascuna, invece di affidarti allo strumento perché la deduca.
Il changelog può essere scritto in italiano?
Sì. Scegli l'italiano come lingua di uscita e le voci vengono scritte in italiano. I titoli dei gruppi, Added, Changed e gli altri, e il prefisso BREAKING restano in inglese perché la convenzione li prevede così. Codice, nomi di funzioni e identificatori non vengono mai tradotti.
Lo strumento aggiunge modifiche che non ho elencato?
No. Lavora solo sugli appunti che incolli e non inventa modifiche, versioni o date. Se la data di rilascio non compare negli appunti, il titolo mostra il segnaposto [YYYY-MM-DD] da completare.
Provalo nel tuo spazio di lavoro
Inizia gratis, senza carta di credito. Quando ti serve di più, la suite cresce con te, dal Lite all'Agency.
Accedi o crea un account gratuito, lo strumento si apre nel tuo spazio di lavoro.