Değişiklik Günlüğü Oluşturucu

Değişiklik günlüğünü elle yazmak, her sürümde git log’u tek tek taramak demektir. Bu araç o adımı atlar: yayınlamak istediğiniz girdileri doğrudan doğru kategoriye, Added, Changed, Fixed ve Removed altına yapıştırır, bir sürüm numarası ve tarih eklersiniz; araç da doğrudan CHANGELOG.md dosyanıza yapıştırabileceğiniz, Keep a Changelog uyumlu bir Markdown bölümü üretir. Aynı içerik düz metin olarak da üretilebilir. Araç git geçmişinizi okumaz; sürüme hangi değişikliklerin gireceğine siz karar verirsiniz.

Değişiklik günlüğü nasıl oluşturulur?

  1. 1

    Sürümü ve tarihi girin

    Sürüm numarasını yazın, örneğin 1.2.0. Bugünün tarihini kullanmak için tarihi boş bırakın.

  2. 2

    Kategorilere göre girdi ekleyin

    Sürüm notlarını Added, Changed, Fixed ve Removed altına yapıştırın; her satıra bir girdi. Boş kategoriler atlanır.

  3. 3

    Çıktı biçimini seçin

    Markdown (`## [sürüm] - tarih` başlığı ve `### Added` tarzı bölümler) veya düz metin (`v1.2.0 (tarih)` başlığı ve madde işaretli listeler).

  4. 4

    Değişiklik günlüğünü kopyalayın

    Çıktıyı CHANGELOG.md dosyasındaki önceki girdinin üstüne yapıştırın.

Dört kategori

Oluşturucu tam olarak dört bölüm üretir ve bu sırayla: Added, Changed, Fixed ve Removed. Çıktıdaki bölüm başlıkları, Keep a Changelog’un standart adlandırması olan İngilizce olarak kalır.

Kategori Ne zaman kullanılır
Added Yeni özellikler
Changed Mevcut işlevlerde yapılan değişiklikler
Fixed Hata düzeltmeleri
Removed Kaldırılan özellikler

Keep a Changelog kuralı Deprecated, Security ve Breaking bölümlerini de içerir. Oluşturucuda bunlar için alan yoktur; çıktıyı yapıştırdıktan sonra bu bölümleri elle ekleyebilirsiniz.

Örnek çıktı (Markdown)

## [1.4.0] - 2026-04-18

### Added
- Dark mode support for the dashboard (#312)
- CSV export on the users page (#318)

### Changed
- Upgrade React to 18.3 (#320)
- Pagination now defaults to 50 items per page (#322)

### Fixed
- Crash when editing users with a null email (#319)
- Timezone offset in scheduled reports (#321)

### Removed
- Legacy reports API (#324)

Örnek çıktı (düz metin)

v1.4.0 (2026-04-18)
ADDED:
  • Dark mode support for the dashboard (#312)
  • CSV export on the users page (#318)
CHANGED:
  • Upgrade React to 18.3 (#320)
  • Pagination now defaults to 50 items per page (#322)
FIXED:
  • Crash when editing users with a null email (#319)
  • Timezone offset in scheduled reports (#321)
REMOVED:
  • Legacy reports API (#324)

İpuçları

  • Her satıra bir girdi. Bir alandaki her satır tek bir madde işaretine dönüşür. Boş alanlar atlanır ve bir kategoriyi tamamen boş bırakabilirsiniz.
  • Girdileri değişiklik günlüğü satırı gibi yazın, log notu gibi değil. Emir kipi “fix: handle null email on edit” madde işareti olarak iyi okunur.
  • Issue/PR numaralarına atıf yapın ki okuyucular derinlemesine inceleyebilsin: çıktıda (#319) veya [#319](link).
  • Her girdiye bir sürüm: arada yalnızca bir gün olsa bile iki sürümü tek blokta birleştirmeyin.
  • Yayınlanan ve yayınlanmayan: bir sonraki sürüm için ayrılan değişiklikleri üstte [Yayınlanmadı] bölümünde tutun ve sürüm çıktığında tarihli bölüme taşıyın.

Sık Sorulan Sorular

Keep a Changelog (keepachangelog.com) kurallarını izler: tarih içeren sürüm başlığı ve gruplanmış madde işaretli listeler. Oluşturucu Added, Changed, Fixed ve Removed bölümlerini üretir; diğer standart bölümler (Deprecated, Security, Breaking) elle eklerseniz aynı kurala uyar.

Oluşturucu dört ana bölüm üretir: Added, Changed, Fixed ve Removed. Deprecated, Security veya Breaking için ayrılmış alan yoktur; ancak bu bölümleri yapıştırmadan önce üretilen metne elle ekleyebilirsiniz.

Oluşturucu tek seferlik bir arayüz aracıdır; otomasyon için aynı kalıpları derleme hattınızda uygulayan standard-version, release-please veya semantic-release gibi bir CLI kullanın.

Hayır. Deponuzu veya commit mesajlarınızı okumaz; girdileri siz yapıştırırsınız. Yazdığınız metin, çıktıyı oluşturmak için sunucuya gönderilir ve saklanmaz ya da paylaşılmaz.

İlgili Araçlar