Engineering
Changelogs als Build-Artefakt: Konventionen, Automatisierung, Pipelines.
Zum Einstieg: Keep a Changelog erklärt, mit CHANGELOG.md-Vorlage, Von Conventional Commits zum Changelog, Changelog-Automatisierung: was automatisieren, was nicht
-
Was ist ein Hotfix? Bedeutung, Hotfix vs. Patch, Ablauf
Ein Hotfix ist eine dringende Korrektur außerhalb des Release-Zyklus. Bedeutung, Unterschied zu Patch und Bugfix und wie man ihn sicher ausliefert.
Engineering6 Min. Lesezeit
-
Release Candidate (RC): Bedeutung und wie man einen fährt
Ein Release Candidate wird zur finalen Version, wenn Tests keinen Blocker finden. Wo der RC nach der Beta steht, wie man ihn versioniert, Ausstiegsregeln.
Engineering5 Min. Lesezeit
-
CHANGELOG.md: was hinein gehört und wie sie aktuell bleibt
Eine CHANGELOG.md hält pro Version fest, was sich für Nutzerinnen geändert hat. Die Rubriken, ein volles Beispiel und die Gewohnheit, die sie aktuell hält.
Engineering5 Min. Lesezeit
-
GitHub Release Notes: generieren, dann lesbar machen
GitHub entwirft Release Notes aus gemergten Pull Requests mit einem Klick. Was der Entwurf enthält, wie release.yml ihn formt und wie man ihn lesbar macht.
Engineering6 Min. Lesezeit
-
Release-Management-Prozess für Teams, die oft ausliefern
Ein Release-Management-Prozess für Softwareteams in sieben Schritten, mit Verantwortlichen und Abschlusskriterien, dazu die DORA-Metriken und mehr.
Engineering7 Min. Lesezeit
-
Wer schreibt den Changelog, und wer sollte
Wer schreibt den Changelog? Die PR-Autorin weiß, was sich änderte, die PM, warum es zählt. Keine allein schreibt einen Eintrag, der Kunden etwas nützt.
Engineering5 Min. Lesezeit
-
Changelog-Dateiformate: JSON, YAML oder einfach Markdown
Das Dateiformat eines Changelogs entscheidet, ob er eine Seite speisen kann oder nur Menschen dient. Markdown, JSON und YAML kosten jeweils anderes.
Engineering5 Min. Lesezeit
-
Changelog-Eintrag in GitHub Actions erzwingen: Workflow
Ein Changelog-Check in GitHub Actions blockiert Merges ohne Eintrag, weil ein Schritt, der auf Erinnerung setzt, scheitert. Und was der Check kaputt macht.
Engineering5 Min. Lesezeit
-
Git-Tags vs. GitHub-Releases vs. Changelog
Ein Git-Tag, ein Release, ein Changelog-Eintrag: drei Aufzeichnungen desselben Ereignisses. Vermischt man sie, driftet der Changelog vom Ausgelieferten ab.
Engineering5 Min. Lesezeit
-
Monorepo-Changelogs: Einer, oder einer pro Paket?
Ein Monorepo kann ein Changelog fürs ganze Repo führen oder eines pro Paket, und die falsche Wahl macht jeden Release zu unübersichtlich oder zu verstreut.
Engineering5 Min. Lesezeit
-
Semantic Versioning und Changelog: was jeder Sprung bedeutet
Semantic Versioning sagt, wie sehr ein Release wehtun kann, vor dem ersten Wort im Changelog. Was jede Zahl verspricht, und was ein Eintrag dafür schuldet.
Engineering5 Min. Lesezeit
-
Öffentliche Changelog-Seite: so baut man eine zum Abonnieren
Eine Changelog-Seite lohnt sich, wenn jemand zurückkehrt. Wo sie leben sollte, was ein Eintrag braucht, Feeds und Markup, und wie das Widget dazu passt.
Engineering6 Min. Lesezeit
-
Changelog-Automatisierung: was automatisieren, was nicht
Automatisiere Sammeln, Formatieren und Veröffentlichen. Nicht Auswahl oder Formulierung. Wo die Grenze liegt und was bei jeder Verschiebung passiert.
Engineering6 Min. Lesezeit
-
Von Conventional Commits zum Changelog
Conventional Commits machen einen Changelog ableitbar, aber nicht lesbar. Was die Konvention bringt, wo sie aufhört und wie man die Lücke schließt.
Engineering6 Min. Lesezeit
-
Keep a Changelog erklärt, mit CHANGELOG.md-Vorlage
Die Keep-a-Changelog-Spezifikation ist eine Seite lang. Bei der Umsetzung driften Teams ab. Was sie sagt, was sie offenlässt und wo es schiefgeht.
Engineering5 Min. Lesezeit