Changelog Automation
Conventional Commits
Commit mesajlari bu formatta olmali:
<type>(<scope>): <description> [optional body] [optional footer(s)]
Type'lar
| Type | Aciklama | SemVer Etkisi |
|---|---|---|
| feat | Yeni ozellik | MINOR |
| fix | Bug fix | PATCH |
| docs | Dokumantasyon | - |
| style | Formatting (kod degisikligi yok) | - |
| refactor | Kod degisikligi (feature/fix degil) | - |
| perf | Performans iyilestirme | PATCH |
| test | Test ekleme/duzeltme | - |
| chore | Build, CI, tooling | - |
| ci | CI/CD degisikligi | - |
| build | Build sistemi degisikligi | - |
| revert | Geri alma | PATCH |
Breaking Change
feat(api)!: remove deprecated endpoints BREAKING CHANGE: /v1/users endpoint kaldirildi, /v2/users kullanin
! isareti veya BREAKING CHANGE: footer'i = MAJOR versiyon artisi.
Semantic Versioning (SemVer)
MAJOR.MINOR.PATCH MAJOR: Breaking change (geriye uyumsuz) MINOR: Yeni ozellik (geriye uyumlu) PATCH: Bug fix (geriye uyumlu)
Versiyon Artirma Kurallari
Commit'lerde BREAKING CHANGE varsa → MAJOR++ Commit'lerde feat varsa → MINOR++ Sadece fix/perf/refactor varsa → PATCH++ Sadece docs/style/test/chore varsa → versiyon artmaz
CHANGELOG.md Formati (Keep a Changelog)
markdown# Changelog All notable changes to this project will be documented in this file. ## [Unreleased] ## [1.2.0] - 2026-03-25 ### Added - Yeni ozellik aciklamasi (#123) ### Changed - Degisiklik aciklamasi (#124) ### Deprecated - Kaldirilacak ozellik uyarisi ### Removed - Kaldirilan ozellik ### Fixed - Bug fix aciklamasi (#125) ### Security - Guvenlik duzeltmesi ## [1.1.0] - 2026-03-20 ### Added - ... [Unreleased]: https://github.com/user/repo/compare/v1.2.0...HEAD [1.2.0]: https://github.com/user/repo/compare/v1.1.0...v1.2.0 [1.1.0]: https://github.com/user/repo/releases/tag/v1.1.0
Type -> Section Mapping
| Commit Type | Changelog Section |
|---|---|
| feat | Added |
| fix | Fixed |
| perf | Changed |
| refactor | Changed |
| docs | - (changelog'a eklenmez) |
| style | - |
| test | - |
| chore | - |
| BREAKING CHANGE | Removed / Changed (breaking note ile) |
| security fix | Security |
| deprecation | Deprecated |
Changelog Olusturma
Git Log'dan Changelog
bash# Son tag'den bu yana commit'ler git log $(git describe --tags --abbrev=0)..HEAD --pretty=format:"%s" --no-merges # Tum tag'ler arasi git log v1.0.0..v1.1.0 --pretty=format:"- %s (%h)" --no-merges # Conventional commit parse git log --pretty=format:"%s" | grep -E "^(feat|fix|refactor|perf|docs|test|chore|ci|build)"
Otomatik Changelog Script
bash# Son release'den bu yana degisiklikleri kategorize et LAST_TAG=$(git describe --tags --abbrev=0 2>/dev/null || echo "") if [ -z "$LAST_TAG" ]; then RANGE="HEAD" else RANGE="${LAST_TAG}..HEAD" fi echo "## [Unreleased]" echo "" echo "### Added" git log $RANGE --pretty=format:"- %s" --no-merges | grep "^- feat" | sed 's/^- feat[^:]*: /- /' echo "" echo "### Fixed" git log $RANGE --pretty=format:"- %s" --no-merges | grep "^- fix" | sed 's/^- fix[^:]*: /- /' echo "" echo "### Changed" git log $RANGE --pretty=format:"- %s" --no-merges | grep -E "^- (refactor|perf)" | sed 's/^- [^:]*: /- /'
Release Notes
GitHub Release Olusturma
bash# Changelog'dan release notes VERSION="v1.2.0" NOTES=$(cat <<'EOF' ## What's New ### Features - Feature 1 description - Feature 2 description ### Bug Fixes - Fix 1 description ### Breaking Changes - Breaking change description **Full Changelog**: https://github.com/user/repo/compare/v1.1.0...v1.2.0 EOF ) gh release create "$VERSION" --title "$VERSION" --notes "$NOTES"
Pre-release
bashgh release create "v2.0.0-beta.1" --prerelease --title "v2.0.0 Beta 1" --notes "..."
CI/CD Entegrasyonu
GitHub Actions Changelog
yamlname: Release on: push: tags: ['v*'] jobs: release: runs-on: ubuntu-latest steps: - uses: actions/checkout@v4 with: fetch-depth: 0 - name: Generate changelog run: | PREV_TAG=$(git describe --tags --abbrev=0 HEAD^ 2>/dev/null || echo "") if [ -n "$PREV_TAG" ]; then git log ${PREV_TAG}..HEAD --pretty=format:"- %s" --no-merges > RELEASE_NOTES.md fi - name: Create Release uses: softprops/action-gh-release@v1 with: body_path: RELEASE_NOTES.md
Breaking Change Tespiti
bash# Breaking change iceren commit'leri bul git log --pretty=format:"%H %s" | grep -i "breaking\|BREAKING CHANGE\|!" # feat! veya fix! formatinda git log --pretty=format:"%s" | grep -E "^(feat|fix|refactor)!"
Changelog Validation
Changelog formatini dogrulama kurallari:
- Her version header'i tarih icermeli:
## [X.Y.Z] - YYYY-MM-DD - Section'lar dogru sirayla: Added, Changed, Deprecated, Removed, Fixed, Security
- Bos section olmamali
- Link referanslari dosya sonunda olmali
- Unreleased section en ustte olmali
Session Changelog Hook
changelog-on-release.ts Stop hook'u session sonunda:
- Session'da yapilan commit'leri otomatik toplar
- Conventional commit formatinda parse eder
- Ozet changelog gosterir
