Engineering
Changelogs als build-artefact: conventies, automatisering, pipelines.
Begin hier: Keep a Changelog uitgelegd, met CHANGELOG.md-template, Van conventional commits naar een changelog, Changelog-automatisering: wat wel, wat niet
-
Wat is een hotfix? Betekenis, hotfix vs patch en uitrollen
Een hotfix is een dringende fix buiten de releasecyclus. Wat de term betekent, hoe hij verschilt van een patch of bugfix en hoe je er veilig een uitbrengt.
Engineering6 min lezen
-
Release candidate (RC): wat het is en hoe je er een draait
Een release candidate is een build die als definitieve versie uitkomt, tenzij testen een blokkade vindt. Plek na bèta, versienummers en exitregels.
Engineering5 min lezen
-
CHANGELOG.md: wat erin hoort en hoe je het actueel houdt
Een CHANGELOG.md vertelt lezers wat er per versie veranderde. De secties die het nodig heeft, een volledig voorbeeld en de gewoonte die het actueel houdt.
Engineering5 min lezen
-
GitHub release notes: genereren en dan leesbaar maken
GitHub maakt release notes uit gemergede pull requests met één klik. Wat het concept bevat, hoe release.yml het vormt en hoe je het leesbaar maakt.
Engineering6 min lezen
-
Releasemanagementproces voor teams die vaak uitbrengen
Een releasemanagementproces voor softwareteams in zeven stappen, met per stap een eigenaar en exitcriteria, plus de DORA-metrics en een extra KPI.
Engineering7 min lezen
-
Wie schrijft de changelog, en wie zou dat moeten doen
Wie schrijft de changelog? De PR-auteur weet wat er veranderde, de PM waarom het telt. Alleen schrijft geen van beiden een item dat klanten helpt.
Engineering5 min lezen
-
Changelog-bestandsformaten: JSON, YAML of gewoon Markdown
Het bestandsformaat van een changelog bepaalt of het een pagina en widget kan voeden, of alleen een mens helpt. Markdown, JSON en YAML kosten anders.
Engineering5 min lezen
-
Changelog-entry verplichten in GitHub Actions: workflow
Een changelog-check in GitHub Actions weigert een merge zonder item, want een stap die op geheugen leunt faalt voorspelbaar. En wat die check zelf breekt.
Engineering5 min lezen
-
Git-tags vs GitHub-releases vs een changelog
Een git-tag, een release en een changelog-regel zijn drie registraties van één gebeurtenis. Ze verwarren laat de changelog afdrijven. Hoe ze samenkomen.
Engineering5 min lezen
-
Monorepo-changelogs: één, of één per package?
Een monorepo kan één changelog voor de hele repo hebben of één per package, en de verkeerde keuze maakt elke release te rommelig of te versnipperd.
Engineering5 min lezen
-
Semantic versioning en je changelog: wat elke bump betekent
Semantic versioning vertelt hoeveel pijn een release kan doen, nog voor je een woord changelog leest. Wat elk cijfer belooft en wat een regel schuldig is.
Engineering6 min lezen
-
Publieke changelogpagina bouwen die mensen volgen
Een changelogpagina is de moeite waard als iemand erop terugkomt. Waar hij moet leven, wat elk item nodig heeft, feeds en markup, en waar de widget past.
Engineering6 min lezen
-
Changelog-automatisering: wat wel, wat niet
Automatiseer verzameling, opmaak en publicatie. Automatiseer geen selectie of formulering. Waar de grens ligt en wat er gebeurt als hij verschuift.
Engineering7 min lezen
-
Van conventional commits naar een changelog
Conventional commits maken een changelog afleidbaar. Ze maken hem niet leesbaar. Wat de conventie oplevert, waar hij stopt, en hoe je de kloof overbrugt.
Engineering6 min lezen
-
Keep a Changelog uitgelegd, met CHANGELOG.md-template
De spec is één pagina en kost tien minuten om te lezen. Bij implementatie glijden teams af. Wat hij zegt, wat hij openlaat, en waar het misgaat.
Engineering6 min lezen