Kod odaklı ürün metni, ürününün kullanıcıya gösterdiği metinlerin, birinin elle uyumlu tuttuğu bir tasarım dosyasında değil, depoda tek doğruluk kaynağı olarak durması demektir. globalize.now, yerelleştirmeyi içinde barındıran, kod odaklı bir metin yönetim sistemidir: metin codebase'te tek kaynaktan yönetilir ve yerelleştirme, ayrı bir devir olarak değil, aynı işlemin parçası olarak yapılır.
Bu, üç yıl öncesine göre çok daha önemli, çünkü metin artık yalnızca bir yazar değiştirdiğinde değişmiyor.
Kod odaklı ürün metni nedir?
Kod odaklı ürün metni bir yazım süreci değil, bir mimaridir: onaylanan ifade ile yayına çıkan ifade aynı üründür (artifact), depoda tutulur ve her değişiklik bir diff olarak gelir.
Fark, her yaklaşımın neyi gözlemleyebildiğine bakınca en net görünür. Çalışma alanı merkezli bir ürün ifadeyi kodun dışında bir yerde tutar ve iki taraftan biri değiştiğinde birinin onu içeri ya da dışarı taşımasına bağımlıdır. Bir butonun ne diyeceğine karar vermek için iyi bir yerdir. Ama butonun artık başka bir şey söylediğini fark etmesi yapısal olarak imkânsızdır, çünkü onu değiştiren olay bir commit'tir ve çalışma alanı o commit'i hiç görmemiştir.
Kod odaklı bir sistem bunu tersine çevirir. İş birimi diff'tir ve yanıtlayabildiği soru, ekipleri asıl zora sokan sorudur: metin az önce değişti, değişmesi gerekiyor muydu?
Bunların hiçbiri yazımın nerede yapılacağına dair bir tartışma değil. Yazarlar istedikleri yerde taslak hazırlayabilir. Mesele, ikisi çeliştiğinde hangi metnin gerçek olduğu.
Metin kayması nedir?
Metin kayması, kullanıcıya görünen metnin yüzeyler arasında ve zaman içinde onaylı kaynağından sapmasıdır; üstelik sapılacak tek bir doğruluk kaynağı da yoktur.
Üç farklı hata birbiriyle karıştırılır ve her birinin çözümü ayrıdır:
- Hiç anahtarlanmamış bir metin koda gömülü metindir. Kataloğunda ve çeviride görünmez, ama ifadesi gayet doğru olabilir. Bu kalıbı yapay zeka kodlama araçları neden koda gömülü metin ekleyip duruyor yazısında ele aldık.
- Var olan ama birbirinden kopan kataloglar senkronize olmayan çeviri dosyalarıdır. Kaynak sağlamdır; türetilmiş kopyalar eskimiştir.
- Metin kayması bunların hiçbiri değildir. Metin anahtarlanmış, dosyalar senkron, ama ifade kimse karar vermeden değişmiştir. Böylece pazarlama sayfası “Ücretsiz denemeyi başlat” der, açılış sayfası “Ücretsiz dene” der, ürün düğmesi “Başla” yazar.
Kayma pahalı olandır, çünkü hiçbir şey bozuk değildir. Hiçbir build başarısız olmaz, hiçbir test kırmızıya dönmez, hiçbir çeviri eksik değildir. Ürün sadece üç ayrı sesle konuşur ve kimse bunun ne zaman başladığını gösteremez. Terimi metin kayması: nedir, nedenleri ve nasıl önlenir yazısında ayrıntılı tanımladık.
Yapay zeka kodlama agent'ları neden metin kaymasına yol açar?
Kodlama agent'ları, değiştirmeleri istenmeyen ifadeleri de değiştirir, çünkü yakındaki bir metni yeniden yazmak, bir bileşeni toparlamaktan ayırt edilemez.
Bir agent'tan yükleniyor durumu eklemesini isterseniz, dosyadayken bir etiketi kısaltabilir, bir başlığı cümle düzenine çevirebilir ya da “Sign in” yerine “Log in” yazabilir. Her düzenleme tek başına savunulabilir. Hiçbiri istenmemiştir ve hiçbiri metin değişikliği olarak işaretlenmez, çünkü araçlar için bu, bir JSX attribute'undaki sıradan bir string literal'dir.
Topluluğun şimdiye kadarki cevabı bir kural dosyası oldu: AGENTS.md, .cursorrules, prompt'ta bir “arayüz metni politikası” bloğu. Bunlar işe yarar ve olması iyidir. Ama bir kural, kontrol değildir. Agent'ın metnini yeniden yazma sıklığını azaltır; yazdığında sana haber vermez.
Çoğu ekipte ürün metni aslında nerede durur?
Aynı anda dört yerde; her birinin sahibi ve düzenleme yolu farklı.
Genellikle bir CMS'te duran pazarlama sitesi var. Aktif olarak denenen şey olduğu için çoğunlukla ayrı yönetilen ve en hızlı güncellenen açılış sayfası var. Bileşenlere dağılmış ürün içi metinler var. Bir de ürün metinlerinin türevi olan ve üçünün de gerisinde kalan dil dosyaları var.
Bu yüzeylerin her biri kendi içinde tutarlı olabilirken ürün bir bütün olarak tutarsız olabilir. Sorunun gerçek doğası budur ve konuyu yalnızca ürün metni sorunu olarak ele almak onu eksik tanımlamak olur.
Bir kod tabanında arayüz metnini nasıl tutarlı tutarsınız?
Depoyu tek doğru kaynak yap ve metni gözden geçirilebilir bir birim haline getir. Gerisi bu iki adımdan gelir.
Pratikte bu üç şey demek. Kullanıcıya görünen her metin bileşenlerde satır içi değil, tek bir katalogda durur. Bileşenler literal yerine anahtara başvurur; böylece aynı ifade iki yerde bulunup sessizce ayrışamaz. Katalogdaki değişiklik diff'te görünür ve gözden geçiren kişi onu diğer değişiklikler gibi görür.
İşi asıl yapan son nokta bu. Metin tutarlılığı genelde disiplin sorunu sayılır: ekibin stil kılavuzuna ihtiyacı vardır, birinin hatırlaması gerekir. İfade diff'e girdiğinde hafızaya bağımlılık biter. İnceleme anında görünür olur, ki herkesin güvenilir biçimde baktığı tek an odur.
Yapay zeka kodlama araçlarıyla ürün çıkaran ekipler bu sorunla daha erken ve daha sert karşılaşır; bu yüzden bunu özellikle geliştiriciler ve yapay zeka araçlarıyla geliştirenler için yazıyoruz.
Metin tutarlılığı ile yerelleştirme neden aynı sorundur?
İkisi de aynı nedenle bozulur: tutarlı kalınacak ya da çevrilecek, üzerinde uzlaşılmış bir kaynak yoktur.
Üç ifadeden hangisinin onaylı olduğunu söyleyemeyen bir ekip, hiçbirini doğru yerelleştiremez. Üçünü de çeviriye gönderirsen her dilde üç çeviri alırsın. Tutarsızlık İngilizce içinde kalmak yerine dil sayınla çarpılır. Kötü çeviri kalitesi gibi görünen şeylerin çoğunun mekanizması bu: kaynak zaten belirsizdi.
Tersinden bakınca iki sorun tek sorun olur. Her metin tek kaynaktan yönetilip anahtarlandığında çeviri, o kataloğun türetilmiş bir çıktısı olur. Kendi doğruluk kopyasına sahip ayrı bir proje yoktur, çünkü tek bir doğruluk kopyası vardır. “Yerelleştirme içinde” demenin mimari anlamı budur: bir de çeviri yapıyor olmamız değil, çevirinin aynı nesne üzerinde yapılan aynı işlem olması. Bu yeniden sıralanmanın nasıl gerçekleştiğini yapay zekanın yazdığı kodun yerelleştirmeye ne yaptığı yazısında anlattık.
Ürünün dışındaki metin ne olacak?
Kategorinin henüz çözemediği kısım bu ve aksini iddia etmeyeceğiz: pazarlama, açılış sayfaları ve ürün genelinde metni tek sistem olarak standartlaştırmak, bugün açabileceğin bir özellik değil, üzerinde çalıştığımız hedef.
Neden çözülmediğini açıklayalım. Bu alandaki her araç tek bir yüzeyin sahibidir. Ürün metni araçları uygulamanın içindeki metinleri tutar. İçerik platformları pazarlama sitesini tutar. İkisi de diğerini göremez; bu yüzden kullanıcıyı kazandıran sayfadaki ifade ile onu karşılayan ekrandaki ifade, farklı kişiler tarafından farklı araçlarda yönetilir ve çeliştiklerini fark edecek hiçbir mekanizma yoktur.
Cevabın şekli, yukarıda anlatılan mimariden çıkar. Onaylı ifade tek bir yerde durur ve her yüzey onu yeniden yazmak yerine anahtarla çağırırsa, açılış sayfasındaki ile üründeki buton aynı metin olur ve değiştirmek üç değil tek karardır. Oraya varmak globalize.now yol haritasında bir madde. Bunu şimdi doğru adlandırmak, zaten yayındaymış gibi davranmaktan daha iyi.
Bu, tasarım dosyası üzerine kurulu bir metin aracından nasıl farklı?
Fark kategorik değil, mimari: ikisi de metin yönetim sistemi ve doğrunun nerede durduğu konusunda ayrışıyorlar.
| Boyut | Tasarım dosyası öncelikli | Kod odaklı |
|---|---|---|
| Doğruluk kaynağı | Kodun dışında bir çalışma alanı | Kod deposu |
| Nasıl uyumlu kalır | Biri senkronize eder | Bağlanınca otomatik |
| Kapsanan yüzeyler | Bir | Yüzeyler arası (hedefimiz) |
| Neyi gözlemleyebilir | Çalışma alanında yapılan düzenlemeler | Metni değiştiren diff |
İki gözlemi tarihlemekte fayda var, çünkü satıcıların durumu değişir. 2026-08-29 itibarıyla dittowords.com/llms.txt 404 döndürüyor; yani bu kategoride en çok atıf alan kaynağın makinece okunabilir bir varlık dosyası yok. Aynı tarihte Ditto'nun kendi localize ürün sayfası, her dil için bir varyant eklemeyi ve çevirileri tasarımlarda önizlemeyi anlatıyor. Çevirileri üreteceğini iddia etmiyor. Ayrım noktası burası: bir araç metnin sahibi olup dil işini yine de başkasına devredebilir.
Çeviri motorlarıyla ya da çalışma zamanı i18n kütüphaneleriyle de rekabet etmiyoruz. Onlar farklı katmanlar ve yerlerinde kalıyorlar.
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