Bir açık kaynak projesinin bugün kaç yıldızı olduğunu görmek kolaydır; asıl zor olan bu sayının zaman içinde nasıl değiştiğini ölçmektir. GitHub, 4 Eylül 2026’da duyurduğu yeni REST API uç noktasıyla geçmiş yıldız sayılarını zaman damgalarıyla sunmaya başladı. Üstelik bunu, projeyi yıldızlayan kişilerin kimliklerini açmadan yapıyor.
Bu küçük görünen değişiklik geliştirici ilişkileri, açık kaynak pazarlaması ve teknik ürün analizi için önemli. Çünkü tek bir toplam sayı; lansman etkisini, düzenli büyümeyi veya kısa süreli ilgiyi birbirinden ayıramaz. Zaman serisi ise hangi sürümün, konferansın ya da rehberin gerçek ilgi ürettiğini göstermeye yardımcı olur.
GitHub neden yeni bir yıldız geçmişi API’si açtı?
GitHub’ın açıklamasına göre 2026’nın başlarında yıldızlayan kullanıcıları listeleyen uç noktalar gizlilik nedeniyle depo yöneticileri ve katkıda bulunanlarla sınırlandırıldı. Bu karar kişi kimliğini korudu, fakat yıldız büyümesini izleyen araçların önemli bir veri kaynağını da kesti. Yeni uç nokta bu ihtiyacı toplulaştırılmış geçmiş sayılarla karşılıyor.
Aradaki fark nettir: yeni veri “kim yıldız verdi?” sorusuna cevap vermez; “deponun yıldız sayısı hangi tarihte kaça ulaştı?” sorusuna cevap verir. Böylece bir kullanıcının hesabını, profilini veya davranışını toplamadan proje eğilimi ölçülebilir.
Toplam yıldız sayısı neden tek başına yetersiz?
On bin yıldızlı iki proje aynı güçte görünse de geçmişleri tamamen farklı olabilir. Biri beş yılda istikrarlı biçimde büyümüş, diğeri tek bir sosyal medya paylaşımıyla bir haftada sıçrayıp sonra durmuş olabilir. İlk proje kalıcı kullanım ilgisine, ikincisi ise görünürlük dalgasına işaret edebilir. Elbette yıldız, kurulum veya aktif kullanım değildir; yalnızca niyet ve ilgi sinyalidir.
Bu nedenle grafik yorumunda yıldız geçmişini sürüm indirmeleri, paket indirme sayıları, sorun bildirimleri, katkıda bulunan sayısı ve dokümantasyon trafiğiyle birlikte ele almak gerekir. Tek metriğe göre “en iyi proje” kararı vermek yanıltıcıdır.
Hangi sorulara cevap verebilirsiniz?
Lansman gerçekten ilgi gördü mü?
Yeni sürümün duyuru tarihini yıldız eğrisi üzerine koyun. Duyurudan sonraki yedi ve otuz günlük artışı önceki eşdeğer dönemle karşılaştırın. Yalnız mutlak artışa değil, büyüme hızındaki değişime bakın. Büyük bir deponun yüz yeni yıldızı ile küçük bir deponun yüz yeni yıldızı aynı anlama gelmez.
İlgi kalıcı mı, tek seferlik mi?
Bir haber sonrası keskin sıçrama doğal olabilir. Önemli olan sonraki haftalarda taban büyüme hızının yükselip yükselmediğidir. Artış hemen eski seviyesine dönüyorsa kampanya görünürlük üretmiş, fakat topluluğa dönüşmemiş olabilir. Düzenli dokümantasyon ve örnek projeler, ani sıçramadan daha sağlıklı bir uzun dönem sinyali verebilir.
Benzer projeler adil biçimde nasıl karşılaştırılır?
Mutlak sayılar yerine aynı yaş aralığını ve aynı zaman penceresini kullanın. Üç aylık bir araçla on yıllık kütüphaneyi toplam yıldız üzerinden yarıştırmak anlamsızdır. İlk 90 gün, son 30 gün ve sürüm sonrası 14 gün gibi ortak pencereler seçin. Projelerin farklı hedef kitlelere sahip olduğunu raporda açıkça belirtin.
Basit ve gizlilik dostu bir ölçüm planı
- İzlenecek depo listesini ve ölçüm amacını yazın.
- API’den gelen tarih-sayı çiftlerini ham biçimde saklayın.
- Günlük farkı ve yedi günlük hareketli ortalamayı hesaplayın.
- Sürüm, duyuru ve etkinlik tarihlerini ayrı bir olay tablosunda tutun.
- Yıldız verisini indirme, trafik veya katkı metriğiyle birlikte yorumlayın.
- Kişi profili çıkarmayın; toplulaştırılmış verinin amacını aşmayın.
Raporu haftalık çalıştırmak çoğu proje için yeterlidir. Saatlik sorgu, değişim yavaşsa ek değer sağlamaz ve gereksiz API trafiği oluşturur. GitHub’ın güncel REST API belgesindeki kimlik doğrulama, sürüm başlığı ve oran sınırı kurallarını izlemek gerekir.
Ham veriyi sonradan değiştirmek yerine her çekimin tarihini, kullanılan uç noktayı ve API sürümünü kaydedin. Böylece GitHub veri biçimini değiştirdiğinde grafikteki kırılmanın gerçek kullanıcı ilgisinden mi yoksa toplama yönteminden mi kaynaklandığını ayırabilirsiniz. Yeniden adlandırılan veya başka hesaba taşınan depolarda kalıcı depo kimliğini de saklamak, aynı projeyi iki ayrı seri gibi sayma riskini azaltır.
Bir karşılaştırma panosu hazırlıyorsanız eksik günleri otomatik olarak sıfır artışla doldurmayın. Eksiklik, API hatası veya zamanlama problemi olabilir. Grafikte veri boşluğunu görünür bırakın ve rapora yöntem notu ekleyin. Bu basit şeffaflık, pazarlama sunumunda kesinlik izlenimi veren ama gerçekte eksik olan çizgilerden daha değerlidir.
Türkiye’deki ekipler için kullanım alanları
Türkçe açık kaynak projeleri çoğu zaman ürün analitiği bütçesine sahip değil. Yıldız geçmişi; topluluk etkinliği, üniversite iş birliği veya yeni Türkçe dokümantasyonun etkisini düşük maliyetle ölçebilir. Ajanslar da müşteriye “toplam yıldız arttı” demek yerine, belirli bir çalışma sonrasında büyüme hızındaki değişimi gösterebilir.
Ancak bu sayı çalışan performansını değerlendirmek veya kişileri hedeflemek için kullanılmamalı. Yeni uç noktanın tasarımındaki gizlilik ilkesi korunmalı: ölçüm projenin eğilimine odaklanmalı, kullanıcı kimliklerine değil.
Yayınlamadan önce veri testi
- Aynı tarih için yinelenen kayıt var mı?
- Zaman dilimi ve gün sınırı raporda açık mı?
- Eksik günler sıfır artış gibi yorumlanıyor mu?
- Depo adı değiştiğinde geçmiş seri korunuyor mu?
- Grafik, yıldızı aktif kullanıcı olarak göstermiyor mu?
Bu kontroller, güzel görünen fakat yanlış hikâye anlatan grafikleri önler. Dosya ve veri bütünlüğünü ayrıca doğrulamak isterseniz SHA-256 dosya doğrulama rehberine bakabilirsiniz.
Kaynak
GitHub Changelog — New API endpoint provides privacy-safe star history data, 4 Eylül 2026
