Ingegneria
Il changelog come artefatto di build: convenzioni, automazione, pipeline.
Inizia da qui: Keep a Changelog spiegato, con un template CHANGELOG.md, Dai conventional commits a un changelog, Automazione del changelog: cosa automatizzare e cosa no
-
Cos'è un hotfix? Significato, hotfix vs patch e rilascio
Un hotfix è una correzione urgente rilasciata fuori dal ciclo di release normale. Cosa significa, come si distingue da patch e bugfix, come rilasciarlo.
Ingegneria7 min di lettura
-
Release candidate (RC): cos'è e come gestirla
Una release candidate è una build che esce come versione finale se i test non trovano blocchi. Dove sta dopo la beta, come numerarla e i criteri di uscita.
Ingegneria5 min di lettura
-
CHANGELOG.md: cosa contiene e come tenerlo aggiornato
Un CHANGELOG.md registra per i lettori ciò che cambia in ogni versione. Le sezioni che servono, un esempio completo e l'abitudine che lo tiene aggiornato.
Ingegneria6 min di lettura
-
Release notes su GitHub: generarle, poi renderle leggibili
GitHub crea una bozza di release notes dalle pull request integrate con un clic. Cosa contiene, come la struttura release.yml e come renderla leggibile.
Ingegneria7 min di lettura
-
Processo di release management per chi rilascia spesso
Un processo di release management in sette passi, con responsabile e criteri di uscita per ciascuno, più le metriche DORA e un altro KPI da seguire.
Ingegneria8 min di lettura
-
Chi scrive il changelog, e chi dovrebbe
Chi scrive il changelog? Chi apre la PR sa cosa è cambiato, la PM perché conta. Nessuna delle due scrive sola una voce utile, e sceglierne una la logora.
Ingegneria5 min di lettura
-
Formati file del changelog: JSON, YAML o solo Markdown
Il formato del file di un changelog decide se alimenta una pagina e un widget, o solo lo legge una persona. Markdown, JSON e YAML costano cose diverse.
Ingegneria6 min di lettura
-
Imporre una voce di changelog in GitHub Actions: workflow
Un check di changelog in GitHub Actions rifiuta il merge senza una voce, perché affidarsi alla memoria fallisce puntualmente. E cosa rompe quel check.
Ingegneria6 min di lettura
-
Tag Git vs release GitHub vs changelog: le differenze
Un tag git, una release e una voce di changelog sono tre registrazioni di un evento. Confonderli fa deragliare il changelog. Come farli combaciare.
Ingegneria6 min di lettura
-
Changelog nei monorepo: uno solo, o uno per pacchetto?
Un monorepo può avere un changelog per tutto il repo o uno per pacchetto, e scegliere male rende ogni release troppo confusa da leggere o troppo dispersa.
Ingegneria6 min di lettura
-
Semantic versioning e changelog: cosa significa ogni salto
Il semantic versioning dice a chi chiama quanto può fargli male una release prima di leggere il changelog. Cosa promette ogni numero e cosa deve una voce.
Ingegneria6 min di lettura
-
Changelog pubblico: come costruire una pagina che si segue
Una pagina di changelog vale la pena quando qualcuno ci torna. Dove dovrebbe vivere, cosa serve a ogni voce, feed e markup, e come si inserisce il widget.
Ingegneria7 min di lettura
-
Automazione del changelog: cosa automatizzare e cosa no
Automatizzate raccolta, formattazione e pubblicazione. Non automatizzate selezione o formulazione. Dove sta il confine e cosa succede quando si muove.
Ingegneria7 min di lettura
-
Dai conventional commits a un changelog
I conventional commit rendono un changelog derivabile. Non lo rendono leggibile. Cosa offre la convenzione, dove si ferma, e come colmare il divario.
Ingegneria6 min di lettura
-
Keep a Changelog spiegato, con un template CHANGELOG.md
La specifica è una pagina e si legge in dieci minuti. Implementarla è dove i team deviano. Cosa dice, cosa lascia aperto, e dove finisce per sbagliare.
Ingegneria6 min di lettura