Changelog Generator

Changelog Generator

Transformeer technische git commits in gepolijste, gebruiksvriendelijke changelogs.

Wanneer Gebruiken

• Release notes voorbereiden voor een nieuwe versie
• Wekelijkse of maandelijkse product-updates samenvatten
• Changelog voor app store submissions
• Interne release documentatie

Instructies

Stap 1: Commits Ophalen

# Sinds laatste tag
git log $(git describe --tags --abbrev=0)..HEAD --oneline --no-merges

# Laatste 7 dagen
git log --since="7 days ago" --oneline --no-merges

# Tussen twee versies
git log v2.4.0..v2.5.0 --oneline --no-merges

Stap 2: Categoriseren

Groepeer commits in deze categorieën:

• ✨ Nieuwe Features — Nieuwe functionaliteit voor de gebruiker
• 🔧 Verbeteringen — Bestaande features die beter werken
• 🐛 Bug Fixes — Opgeloste problemen
• ⚠️ Breaking Changes — Wijzigingen die actie vereisen
• 🔒 Security — Beveiligingsupdates

Stap 3: Vertalen

Regels voor vertaling van technisch → gebruikersvriendelijk:

1. Geen technisch jargon — "Fixed null pointer in auth middleware" → "Inlogproblemen opgelost"
2. Gebruiker-perspectief — Wat verandert er voor hen?
3. Actieve taal — "Je kunt nu..." in plaats van "Er is een optie toegevoegd voor..."
4. Filter ruis — Skip: refactoring, tests, CI/CD, dependency bumps, formatting

Stap 4: Formatteren

# Release Notes — v2.5.0 (31 maart 2026)

## ✨ Nieuw

- **Team Workspaces**: Maak aparte werkruimtes per project.
  Nodig teamleden uit en houd alles georganiseerd.

- **Sneltoetsen**: Druk op ? voor alle beschikbare shortcuts.

## 🔧 Verbeterd

- **Snellere sync**: Bestanden synchroniseren nu 2x sneller
- **Beter zoeken**: Zoekt nu ook in bestandsinhoud

## 🐛 Opgelost

- Grote afbeeldingen konden niet worden geüpload
- Tijdzone-verwarring in geplande berichten

## ⚠️ Let Op

- Minimale Node.js versie is nu 18 (was 16)

Opties

• --format markdown — Standaard, voor CHANGELOG.md
• --format slack — Compacte bullet list voor Slack/Discord
• --format email — HTML-formatted voor e-mail nieuwsbrief
• --lang nl — Nederlands (standaard)
• --lang en — Engels

Tips

• Draai vanuit de root van je git repository
• Gebruik CHANGELOG_STYLE.md in je repo voor consistente opmaak
• Review altijd voor publicatie — AI mist soms context
• Sla op naar CHANGELOG.md en commit mee met de release