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 Git & GitHub Professional Workflow 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 Git & GitHub Professional Workflow, e i tuoi progressi si sincronizzano tra il web e l'app CoddyKit. Il corso Git & GitHub Professional Workflow 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 Git & GitHub Professional Workflow, passa a CoddyKit PRO. Il corso Git & GitHub Professional Workflow 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 Git & GitHub Professional Workflow 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 Git & GitHub Professional Workflow?
Non è richiesta alcuna esperienza precedente. Git & GitHub Professional Workflow 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 Git & GitHub Professional Workflow?
Sì. Ogni lezione Git & GitHub Professional Workflow 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