Çeviri dosyaları kopar, çünkü iki sistem aynı veriye sahiptir ve hiçbiri üstünlük sağlayamaz. Deponuz, bir geliştirici merge ettiğinde değişir. Çeviri dosyalarınız ise biri hatırlayıp güncellediğinde değişir. Bunlar farklı saatlerdir ve aralarındaki boşluk, eksik anahtarların, yetim anahtarların ve eskimiş metinlerin yaşadığı yerdir. globalize.now, anahtarları ve dil dosyalarını kodun yazıldığı yerde üreterek bu boşluğu kapatan, AI destekli yerelleştirme altyapısıdır; geride kalacak ikinci bir saat kalmaz.

Dil dosyalarının senkronu bozulmasına tam olarak ne yol açar?

Bir dosya yazılır, diğerlerinin bakımı yapılır; bunlar aynı iş değildir.

Bir özellik geliştiren geliştirici en.json dosyasını düzenler, çünkü metin oraya gidiyor. Diğer diller başkasının sorunudur ve başkasının takvimine bağlıdır. Bu örüntüyü DEV'de anlatan bir geliştirici iki hata biçimini tarif etti: anahtarlar İngilizce dosyaya eklenip diğerlerinde unutulur, böylece uygulamanın bir kısmı sessizce İngilizceye döner; bir dilde silinen anahtarlar bir başkasında yaşamaya devam eder, böylece ölü kayıtlar birikir. Her iki durumda da sorunu fark etmenin yolu, haftalar sonra gelen bir müşteri şikâyetidir.

Bunların hiçbiri çeviri sorunu değil. Hiçbir şey yanlış çevrilmedi. Metinler hiçbir yere yönlendirilmedi.

Bu hata, her araç yükseltmesinden sağ çıkar, çünkü araçlar metnin oluştuğu yerin akış aşağısındadır. Metin hiç pipeline'a girmiyorsa daha iyi bir pipeline yardımcı olmaz. Aynı kök neden, zincirin daha başında, bir coding agent hiç anahtarlanmamış metinler yazdığında da ortaya çıkar.

Dil dosyaları neden bu kadar çok merge çakışması üretir?

Çünkü bunlar, makinelerin yazması için tasarlanmış bir formatta elle düzenlenen üretilmiş verilerdir.

Dil dosyası, anahtarlardan metinlere giden düz bir eşlemedir. Birer özellik ekleyen iki branch de bu eşlemenin sonuna, genellikle aynı yere, aynı alfabetik komşuluğa ekleme yapar. Git, anlamsal bir yapısı olmayan bir dosyada bitişik satırlara yapılmış iki düzenleme görür ve çözmesi için bir insan ister.

Çakışmayı çözen kişi, hedef dili okumayan bir geliştiricidir. Güvenli hamle iki tarafı da tutmaktır; yinelenen anahtarlar böyle girer. Hızlı hamle birini tutmaktır; çeviriler böyle sessizce silinir.

Kimse lockfile'daki çakışmaları elle çözmez; yeniden üretir. Dil dosyaları, bir kişinin yazdığı belge olmaktan çıktığı anda aynı muameleyi hak eder.

Review'da bekleyen bir çeviri ne kadar eskir?

Ürünü anlatmaktan çıkacak kadar; bu da herkese açık biçimde ölçülebilir.

DevOps.com'da yayımlanan bir saha raporu, açık kaynak projelerdeki beş gerçek yerelleştirme PR'ını inceledi. Öğretici olan Kilo Code PR #8377: otomatik kontroller temiz döndü, maintainer incelemesi sonra geldi ve depo bu arada çoktan değişmişti. PR, güncel mimariye göre yeniden gönderme daveti ile kapatıldı. Aynı rapor, gönüllülerin İspanyolca, Japonca, Portekizce, Korece, Çince ve Vietnamca çeviri önerdiği, maintainer'ların ise bunları kabul edecek bir yolları olmadığını söylediği bir OpenClaw issue'sunu da kaydediyor.

Bunları kalite raporu değil, gecikme raporu olarak oku. Çeviriler yazıldıklarında doğruydu. Kuyrukta beklerken arayüz değişti.

Yerelleştirme araçlarını karşılaştırırken kimsenin fiyatlandırmadığı maliyet bu. Herkes çeviriyi ölçer. Bir metnin yolda ne kadar kaldığını ya da o yokken arayüzün ne yaptığını neredeyse kimse ölçmez.

Gidiş dönüşün gerçek maliyeti nedir?

Çeviriden çok koordinasyonda; faturanın acıyı hiç açıklamamasının nedeni de bu.

Görünen maliyet kelime, anahtar ya da kullanıcı lisansı başına hesaplanır ve ayda bir kez faturada belirir. Görünmeyen maliyet ise şunlardır: “Hangi dosyayı düzenleyeceğim?” diye soran bir geliştirici, okuyamadığı bir dildeki çakışmayı çözmeye çalışan ikinci bir geliştirici, Almanca build'de on bir anahtarın eksik olduğunu fark eden üçüncü bir geliştirici ve beş hafta önce yazdığı bir metin hakkında kendisine soru sorulan özelliğin asıl yazarı.

Bunların hiçbiri fiyat karşılaştırmasında görünmez. Hepsi her sprint'te, geliştirici maliyetiyle ve geliştirici zamanı olarak ödenir. Etiket fiyatı düşük olsa da haftada iki mühendisin bir gününü alan bir araç ucuz değildir.

Bu maliyeti üreten şey gidiş-dönüş trafiğidir. Metinlerin yazıldığı yer ile çevrildiği yer arasında dosya taşımak en pahalı adımdır ve bunu kimden satın alırsan al pahalı kalır. Yerelleştirmenin giderek geliştirme döngüsüne doğru kaymasının nedeni de budur.

Anahtarlar kodun yazıldığı yerde üretildiğinde ne değişir?

İkinci saat ortadan kalkar ve drift'in doğabileceği bir yer kalmaz.

Akış artık şöyle işlemez: geliştirici koda gömülü bir metin yazar, biri sonradan bulur, biri anahtarlar, biri dosyayı dışarı gönderir, biri çevirir, biri geri getirir. Yeni akış şöyledir: metin, özellikle aynı commit'te, değeriyle birlikte bir anahtar olarak yazılır ve çeviri bunun üzerinden gelir.

globalize.now'da bu, tek seferlik bir dönüşümle başlar. Deponu uygulamada bağlarsın, koda gömülü mevcut metinler tek geçişte anahtarlara ve dil dosyalarına çıkarılır. Sonrasında agent Skill'leri, Cursor ve Claude Code gibi kodlama agent'larının metinleri koda gömmek yerine baştan anahtarlı yazmasını sağlar; push işleri de yeni katalog birimleri ortaya çıktıkça onları çevirir.

Önemli kelime “tek seferlik”. Dönüşüm işin zor kısmıdır ve bir kez yapılır. Sonrası eskiden elle yapılan kısımdır ve kodla aynı saatte çalışır. Bunu geliştirici iş akışının yanına değil içine koymanın amacı da tam olarak budur.

Runtime kütüphaneleri etkilenmez. i18next ve next-intl dil dosyalarını eskisi gibi okur. Çevirilerin sunulma şeklinde hiçbir şey değişmez. Değişen tek şey dosyaları kimin yazdığıdır.

Drift ile gerçek bir çeviri sorununu nasıl ayırırsın?

Şunu sor: Bu metni hiçbir çevirmen gördü mü?

Almanca dosyada bir anahtar eksikse çevirmen başarısız olmamıştır. Metin ona hiç ulaşmamıştır. Bu bir yönlendirme hatasıdır ve inceleme adımı eklemek durumu kötüleştirir, çünkü sorunu zaten gecikme olan bir sürece kuyruk süresi ekler.

Almanca dosyada anahtar var ama ifade bağlama uymuyorsa bu gerçek bir çeviri sorunudur ve Almanca bilen, metnin nerede göründüğünü görebilen bir insanı hak eder. Bunlara ayrılan zaman değerlidir.

Çoğu ekipte birincisi ikincisinden çok daha fazladır ve ikisi aynı sorun sanılır; yerelleştirmenin bitmek bilmemesinin nedeni budur. İkisini ayırırsan iş yükü düşer, çünkü işin yönlendirme kısmı artık hiç insan işi olmaktan çıkar. Ekip küçüldükçe bu ayrım daha da önem kazanır; en keskin biçimde de hızlı ürün çıkaran tek kişilik geliştiricilerde ve küçük ekiplerde görülür.

Faydalı bir test: Son on yerelleştirme hatandan kaçının yanlış kelimeden, kaçının eksik kelimeden kaynaklandığını say. Çoğu eksikse çeviri sorunun yok. Tesisat sorunun var ve tesisat, muhakemenin aksine otomatikleştirilebilir. Yerelleştirmenin sana gerçekte ne kadara mal olması gerektiğini hesaplarken de aynı mantık geçerli.

Dil dosyası drift'i, çeviri sorunu kılığına girmiş bir yönlendirme sorunudur. Depoyu bir kez bağla, yönlendirme artık senin işin olmasın.

globalize.now koda gömülü uygulama metinlerini çeviriye hazır dil dosyalarına dönüştürür ve sen yayına aldıkça güncel tutar.

globalize.now'ı ücretsiz dene