Beispielarbeiten · Texte & Doku

Changelog: Release Notes aus einem echten Git-Verlauf, Version nach SemVer

Aus den Commits eines Demo-Repositorys entsteht ein Änderungsprotokoll nach Keep a Changelog und eine kurze Fassung für Kunden. Jeder Commit steht genau einmal da, Bruchänderungen stehen oben, Unklares ist sichtbar, die Versionsnummer folgt der Regel.

Musterarbeit (Demo), kein Kundenauftrag. Gebaut als Probeaufgabe mit erfundenen Beispieldaten; die Prüfzahlen unten stammen aus dem automatischen Prüflauf und sind nicht geschönt.

Was gebaut wurde

Gruppiert nach Conventional Commits, Bruchänderungen zuerst
Nächste Version nach SemVer aus dem Verlauf bestimmt
Nicht Konventionelles steht sichtbar unter Sonstiges
Repository erfunden

CHANGELOG.md herunterladen

Wie geprüft wurde

Automatischer Prüflauf vom 29.10.2026, aus dem Protokoll (Testdaten erfunden, Zahlen gemessen):

Echter Git-Verlauf mit 10 Demo-Commits: jeder genau einmal gruppiert, Bruchaenderung oben, Unklares unter Sonstiges, Version 1.4.2 auf 2.0.0 nach SemVer
Gegenproben Patch, Minor, Major richtig
11 Pruefungen

Alle Prüffälle (11 von 11 grün)

✓ jeder commit genau einmal
✓ bruchaenderung steht oben
✓ sonstiges ist sichtbar
✓ version folgt semver major bei bruch
✓ gegenprobe nur korrekturen ergeben patch
✓ gegenprobe bruch ergibt major
✓ gegenprobe neues ergibt minor
✓ echter git verlauf gelesen
✓ keine ki floskeln
✓ kein versprechen
✓ demo gekennzeichnet

Grenzen

Was diese Probe nicht abdeckt, steht hier, damit niemand mehr erwartet:

So gut wie die Commit-Meldungen; Unklares braucht einen Menschen
Ob eine Aenderung bricht, entscheidet der Inhaber
Veroeffentlichen und Taggen im Kundenrepository nur mit Zugang und Freigabe

Der Bericht

# Changelog und Release Notes - Demo-Projekt Kornblume (erfunden)

Musterarbeit von GL Tools, kein Kundenauftrag. Gegenstand ist ein Demo-Projekt des erfundenen Betriebs Kornblume, selbst geschrieben, ohne echte Schluessel oder Kundendaten.

Gelesen aus einem echten Git-Verlauf mit 10 Commits (Wegwerf-Repository).

## Changelog

# Aenderungsprotokoll

Format nach Keep a Changelog, Versionen nach SemVer. Demo-Projekt Kornblume (erfunden).

## [2.0.0] - 2026-10-29

### Bruchaenderungen

- Schnittstelle liefert Preise in Cent (e54ddf7)

### Sicherheit

- Anmeldung sperrt nach fuenf Fehlversuchen (c24955c)

### Hinzugefuegt

- Bestellung als PDF exportieren (e67ba58)
- Artikel nach Allergenen filtern (bee84ee)

### Behoben

- Rundungsfehler bei Rabatt auf Brot (c8f6392)
- Cent statt Euro im Korb (012a337)

### Verbessert

- Katalog laedt dreimal schneller (4e0acdb)

### Intern

- Preisberechnung in eigenes Modul (baf752d)

### Dokumentation

- Installationshinweise ergaenzt (8fee7c2)

### Sonstiges

- Aufgeraeumt und noch was gemacht (e5b1320)


## Release Notes

Neu in Version 2.0.0 (fuer Kunden, ohne Fachsprache)

- Bestellung als PDF exportieren
- Rundungsfehler bei Rabatt auf Brot
- Cent statt Euro im Korb
- Artikel nach Allergenen filtern
- Katalog laedt dreimal schneller
- Schnittstelle liefert Preise in Cent
- Anmeldung sperrt nach fuenf Fehlversuchen

## Was diese Arbeit nicht kann

Sie ist so gut wie die Commit-Meldungen: wer "Aufgeraeumt und noch was gemacht" schreibt, landet unter Sonstiges und braucht einen Menschen, der es einordnet. Die Versionsnummer folgt SemVer; ob eine Aenderung wirklich bricht, entscheidet der Inhaber.

So etwas für deinen Betrieb?

Beschreib kurz, was du brauchst. Du bekommst einen Festpreis, bevor ich anfange; ohne dein Ja passiert nichts.

Zur Werkstatt