Birleştirilen GitHub Pull Request'lerinden Ürün Changelog'u Oluşturma
GitHub'daki merged PR'lar, sürüm etiketleri ve kapatılan issue'ları temiz bir ürün changelog'una dönüştürün. Commit karmaşasından kurtulun.
Soobrief Ekibi — Ürün ve Mühendislik, Sooapps ·
Kısaca
GitHub'dan müşteriye dönük bir changelog oluşturmak, ana dala birleştirilen pull request'leri `merged_at` zaman damgasına göre filtrelemek ve etiketlerle gruplamaktan geçer. Bu yöntem ham git commit karmaşasını yok ederek temiz ve okunabilir sürüm notları üretir.
GitHub'dan müşteriye dönük bir changelog oluşturmak, ana dala birleştirilen pull request'leri merged_at zaman damgasına göre filtrelemek ve etiketlerle gruplamaktan geçer. Bu yöntem ham git commit karmaşasını yok ederek temiz ve okunabilir sürüm notları üretir.
Git depoları yazılımda neyin teslim edildiğinin mutlak kaynağıdır. Ancak ham commit geçmişini kopyalamak, müşterilerin anlamayacağı teknik detaylar ve yüzlerce küçük commit arasında kaybolmaya yol açar.
1. Doğru Sinyal: Commit'ler Değil, Merged PR'lar
Müşteriye dönük sürüm notu için en sağlıklı veri birimi birleştirilmiş Pull Request'lerdir:
merged_at alanı dolu olmalıdır (kapatılıp birleştirilmeyen PR'lar elenir).
base.ref ana dağıtım dalı (main veya production) olmalıdır.
- Bot kullanıcılar otomatik olarak filtrelenmelidir.
2. Etiketleme ile Deterministik Gruplama
PR başlıklarını anlamlı kategorilere bölmek için etiketler kullanılır:
feature / enhancement: Yeni Özellikler başlığı altına alınır.
bug / fix: Hata Düzeltmeleri başlığına atanır.
performance: Hız ve Altyapı bölümünde vurgulanır.
Bu kural tabanlı sistem sayesinde mühendislik ekibinin haftalık sürüm notu için fazladan tek bir kelime yazmasına gerek kalmaz.