Generare changelog e note di rilascio
Impari a produrre changelog chiari e note di rilascio automatiche dalla cronologia Git e dai conventional commit.
Generare changelog e note di rilascio è una lezione DevOps Bootcamp gratuita su CoddyKit. Questa è la lezione 4 di 4. Puoi leggere la lezione completa qui gratuitamente — poi esercitati direttamente nel browser con un editor di codice integrato e un tutor IA disponibile 24/7. Fa parte del percorso di apprendimento DevOps Bootcamp, e i tuoi progressi si sincronizzano tra il web e l'app CoddyKit. Il corso DevOps Bootcamp include 4 lezioni in totale.
Che cos'è un changelog
Un changelog è un elenco selezionato e leggibile dalle persone delle modifiche più importanti apportate in ogni versione. Si trova in un file come CHANGELOG.md nella radice del repository.
Perché i changelog sono importanti
Gli utenti e i colleghi leggono i changelog per comprendere:
- Le nuove funzionalità
- Le correzioni di bug
- Le modifiche incompatibili
Rendono gli aggiornamenti più sicuri e rapidi.
Formato Keep a Changelog
Una convenzione comune raggruppa le voci sotto intestazioni: Added, Changed, Fixed, Removed.
## [1.2.0] - 2024-05-01
### Added
- Search filters
### Fixed
- Login redirect bugConventional Commits
I Conventional Commits usano prefissi come feat:, fix: e BREAKING CHANGE:, così gli strumenti possono creare automaticamente i changelog.
feat: add CSV export
fix: handle empty cart
feat!: drop Node 14 supportElencare i commit da un tag
Potete vedere in anteprima le modifiche apportate dall'ultima release usando git log con un intervallo di tag.
git log v1.1.0..HEAD --onelineLog formattato per le note
Formattate il log in righe puntate adatte per essere copiate nelle note di rilascio.
git log v1.1.0..HEAD --pretty=format:'- %s'Strumenti per automatizzare i changelog
Strumenti come standard-version o conventional-changelog leggono i Conventional Commits e generano il changelog, oltre ad aggiornare la versione.
npx standard-versionNote generate automaticamente da GitHub
Quando create una release, GitHub può generare automaticamente le note di rilascio a partire dalle pull request unite.
gh release create v1.2.0 --generate-notesCategorizzazione con le etichette
Un file .github/release.yml associa le etichette delle pull request alle sezioni del changelog, raggruppando automaticamente correzioni di bug e funzionalità nelle note.
changelog:
categories:
- title: Features
labels: [feature]Revisione prima della pubblicazione
Leggete sempre le note generate prima di pubblicarle. L'automazione ne crea una bozza, ma spetta a una persona rivedere il testo e mettere in evidenza le modifiche incompatibili.
Collegamento alle release
Collegate ogni voce del changelog al relativo tag Git e alla pagina della release, così i lettori possono passare direttamente al diff esatto.
[1.2.0]: https://github.com/you/repo/compare/v1.1.0...v1.2.0Verifica rapida
Verificate la vostra comprensione dei changelog e delle note di rilascio.
Riepilogo
Avete imparato a generare i changelog:
- Usate il formato Keep a Changelog
- I Conventional Commits alimentano l'automazione
git log v1..HEADmostra in anteprima le modifichegh release create --generate-notescrea una bozza delle note a partire dalle pull request
Domande Frequenti
La lezione «Generare changelog e note di rilascio» è gratuita?
Sì — il testo completo di «Generare changelog e note di rilascio» è gratuito qui sul web. Per esercitarvi in modo interattivo (un editor di codice integrato e un tutor IA 24/7) e sbloccare il resto del corso DevOps Bootcamp, passa a CoddyKit PRO. Il corso DevOps Bootcamp include 4 lezioni in totale.
Cosa imparerò in «Generare changelog e note di rilascio»?
Impari a produrre changelog chiari e note di rilascio automatiche dalla cronologia Git e dai conventional commit. Eserciti DevOps Bootcamp con codice pratico che esegui direttamente nel browser, e un tutor IA 24/7 risponde alle tue domande mentre lavori sulla lezione.
Ho bisogno di esperienza per iniziare DevOps Bootcamp?
Non è richiesta alcuna esperienza precedente. DevOps Bootcamp su CoddyKit è strutturato per principianti e studenti avanzati, quindi puoi iniziare da qui o dall'inizio e procedere al tuo ritmo. Questa è la lezione 4 di 4.
Quanto tempo richiede la lezione «Generare changelog e note di rilascio»?
La maggior parte delle lezioni CoddyKit richiede circa 5–10 minuti. Ogni lezione è breve e interattiva, quindi fai progressi costanti e riprendi esattamente da dove hai lasciato su web e app.
Posso scrivere ed eseguire codice in questa lezione DevOps Bootcamp?
Sì. Ogni lezione DevOps Bootcamp include un editor di codice integrato, quindi scrivi ed esegui codice reale direttamente nel tuo browser e ricevi feedback istantaneo dall'IA — nessuna configurazione locale necessaria.
Tutte le lezioni di questo corso
- Semantic Versioning con i tag
- Creazione e gestione delle release
- Branch di release e hotfix
- Generare changelog e note di rilascio