Linear Döngüleri ve Tamamlanan İşleri Temiz Bir Changelog'a Dönüştürme
Linear Cycle ve tamamlanan issue'ları haftalık changelog'a dönüştürmenin en pratik yolu: completedAt filtresi, etiket eşleme ve webhook mimarisi.
Soobrief Ekibi — Ürün ve Mühendislik, Sooapps ·
Kısaca
Linear'dan profesyonel bir changelog üretmek, belirlenen tarih aralığında `completedAt` damgasına sahip işleri sorgulamak, Linear Takımlarını ürün alanlarına ve etiketleri kategorilere eşlemekle mümkündür. Deterministik kurallar sayesinde Cycle kapanışları anında kullanıcı bültenine dönüşür.
Linear'dan profesyonel bir changelog üretmek, belirlenen tarih aralığında completedAt damgasına sahip işleri sorgulamak, Linear Takımlarını ürün alanlarına ve etiketleri kategorilere eşlemekle mümkündür. Deterministik kurallar sayesinde Cycle kapanışları anında kullanıcı bültenine dönüşür.
Hızlı ürün geliştiren ekipler Linear'ın sade yapısını çok sever. Ancak bir Cycle kapandığında ürün yöneticileri onlarca tamamlanmış kartın içinden hangisinin müşteriye duyurulacağını ayıklamak için saatler harcar.
1. Cycle ve Zaman Damgası Filtresi
Linear işleri Cycle'lar halinde gruplar. Ancak hafta ortasında çıkan hotfix'lerin atlanmaması için hem Cycle hem de completedAt filtresi birlikte değerlendirilir:
query CompletedIssues($teamId: String!, $since: DateTime!) {
issues(
filter: {
team: { id: { eq: $teamId } }
completedAt: { gte: $since }
state: { type: { eq: "completed" } }
}
) {
nodes {
id
title
completedAt
project { name }
labels { nodes { name } }
}
}
}
2. Etiketlerin Bülten Başlıklarına Dönüştürülmesi
Linear etiketleri işin niteliğini açıkça belirtir:
feature → Yeni Özellikler: Bültenin en başında yer alır.fix / bug → Düzeltmeler ve İyileştirmeler: Kullanıcıya sağlanan fayda odaklı listelenir.performance → Hız ve Güvenilirlik: Altyapı optimizasyonlarını vurgular.
Tüm bu süreç kurallara bağlı çalıştığı için her hafta tutarlı ve güvenilir bir çıktı elde edilir.