Çeviri altyapısı satıyoruz. Kendi pazarlama sitemiz de beş dilde yayında. Gerçekten sunduğumuz JSON'u denetlediğimizde ilk bulgu ton sorunu değildi. Bir Almanca birleşik sözcüğün içinde, ilk bakışta neredeyse doğru görünen tek bir yanlış karakterdi: Latin harfin olması gereken yerde bir Kiril harf. Sözcük, code point'e bakana kadar terim sözlüğü girdisi gibi okunuyordu. Kendi çevirilerimiz bozuksa, birisi ürüne neden güvensin?
Asla yayına çıkmaması gereken beş hata
Almanca arayüz metninde Kiril harf. Bir terim sözlüğü satırında karışık yazı sistemi vardı: sonek Latin “ar” gibi görünüyordu ama bir harf Latin değildi. Ana dili Almanca olanlar hemen fark eder. Yazım denetimi etmez.
**The string:** …"Übersetzungsglossар"… (Cyrillic "р" in the compound)
**What it should be:** "Übersetzungsglossar"
**Why it matters:** It reads as corrupted text. It signals automated output nobody proofread in the target language.
Almanca ve Fransızcada hitap düzeyi ters düşmüş. Site bir geliştirici aracı. Üslup, mühendislerin ürün arayüzünde gerçekten yazdığı gibi olmalı. de ve fr dosyalarında her yerde resmi hitap kullanmışız. Bu ufak bir kusur değil. Varsayılan çeviri yolunun, birkaç uç metin değil, tüm yüzey için yanlış hitap düzeyini seçtiği anlamına geliyor.
**The string:** "… wie Sie …" / "vous pouvez …"
**What it should be:** informal "du" / "tu" voice for product and FAQ
**Why it matters:** Every screen sounded like enterprise procurement, not like the product we sell to vibe coders.
Tutarsız para birimi. İngilizce kaynak, aylık etiket gösteren Almanca sürümden farklı bir para birimi gösteriyordu. Ülkeye göre farklı fiyat uygulamıyoruz ve tüm fiyatlar EUR cinsindendir. JSON ise aksini ima ediyordu.
**The string:** "20 €/Monat" (and similar) next to "$20/mo" elsewhere
**What it should be:** one USD amount, formatted per locale via code (e.g. Intl), not hand-invented symbols in JSON
**Why it matters:** Pricing trust. Mixed symbols read as either a bug or a hidden price change.
“Coding” için yanlış dost sözcükler. Üç dilde “coding environment”, kodlama (encoding) anlamına gelen sözcükle çevrilmişti. SSS, insanlara “encoding environment” içinde kalabileceklerini söylüyordu. Ürünün hangi okumasında bakılırsa bakılsın yanlış.
**The string:** Spanish "codificación", Italian "codifica", German "Codierung" in the wrong sense
**What it should be:** development environment wording (e.g. entorno de desarrollo / ambiente di sviluppo / Entwicklungsumgebung)
**Why it matters:** It is a semantic bug. It reads like we do not understand our own domain.
“Ship” posta gönderimi gibi okundu. Almanca ve İtalyanca metinlerde, yazılım yayınlamayı değil koli göndermeyi çağrıştıran fiiller kullanılmıştı. Aynı İngilizce kaynak, yanlış sözcük alanı. Bunun nedeni bilinçli bir stil tercihi değil, düzeltilmemiş makine önerileriydi.
**The string:** parcel-shipping verbs applied to "ship your app"
**What it should be:** release / deploy / deliver software wording
**Why it matters:** Developer trust. One wrong verb tells the reader the copy was never read by a developer in that language.
Otomatik üretilen çeviriler neden kayar
Bu, çevirmenlere karşı bir söylev değil. Sitenin büyük bölümünde metin başına hiç insan kontrolü yoktu. Genel amaçlı modeller varsayılan olarak resmi hitaba yönelir, çünkü açık webdeki toplu iki dilli metin böyle görünür. Hedef “doğru yazı sistemi” değil “makul görünen karakterler” olduğunda, yazı sistemleri arasındaki benzer görünümlü harfleri de karıştırırlar. Terim sözlüğü yoksa komşu anahtarlar arasında sözcük seçimi kayar. Para birimi kuralı yoksa model makul görünen yerel semboller uydurur. Alan kontrolü yoksa encoding ile coding çarpışır. Biz tam olarak bu hata biçimini ortadan kaldırmak için varız. Kendi sitemiz de, bir müşteri gibi denetleyene kadar bunu yayında tuttu.
Temizlikten sonra ne kurduk
Tek seferlik metin düzeltmeleri bir sistem değildir. Kalıcı olan kısım, tüm ekibin (ve gelecekteki her otomatik çeviri batch'inin) yasa gibi kabul edeceği küçük bir politika dosyası ve merge öncesi çalıştırabileceğimiz bir doğrulama betiği.
Politika. i18n/LOCALIZATION_POLICY.md dosyası her locale için dil registerını, JSON'daki yalnızca USD fiyatlandırmayı, alıntı sözcük kararlarını (örneğin vibe coders ifadesinin İngilizce bırakılması), coding ile encoding arasındaki yalancı dost kurallarını ve satır içi literallerin tipografisini belirler. Bilerek kısa tutuldu. Bir kural yazılı değilse model onu tutarlı biçimde çıkarsayamaz.
## Currency
- USD only in all locales. Use {monthlyPrice} and {overageRate} placeholders…
## False friends
- Coding environment is not encoding: Spanish desarrollo / Italian sviluppo / German Entwicklung…
Doğrulama. scripts/verify-translations.sh Latin locale dosyalarında Kiril harflerini, euro sembollerini ve eski yalancı dost alt dizgilerini arar, fiyat placeholder'larının eşitliğini de messages/en.json ile karşılaştırır. İsteğe bağlı kontroller, kuruluysa ripgrep kullanır. Betik bir tavan değil, bir tabandır. “Bir kez düzelttik” durumunun bir sonraki toplu düzenlemede sessizce çürümemesi için vardır.
Daha fazla JSON tahmini değil, kod. Ekranda görünen USD tutarlarını lib/pricing.ts içinde topladık, formatUsdPerMonth ve formatUsdOveragePer1k'yi ana sayfaya ve SSS'ye bağladık. Böylece locale dosyaları rakam uydurmayı bırakır. Sorun yalnızca yanlış metinler değildi. Sorun, ölçek büyümeden önce politikanın ve formatlayıcının yerinde olmamasıydı.
Yapay zekâ destekli i18n için senin de alabileceğin dersler
Çevirileri bir modelle üretiyorsan, register en çok varyans yaratan ayar. Daha fazla dil eklemeden önce onu locale başına sabitle. Para birimini düzyazıda değil kodda sabitle. Marka terimlerini ve geliştirici jargonunu sabitle. “Sonra gözle bakarız” demek yerine batch'i başarısız kılan otomatik kontroller çalıştır. Sonrası, ilk geçişle aynı kalite çıtasında asla gerçekleşmez.
Bu denetimin altındaki mimari hikâye için Yapay Zekâyla Üretilmiş Bir Uygulama Nasıl Yerelleştirilir yazısını ve araç karşılaştırması için globalize.now, Lokalise ve Crowdin karşılaştırması yazısını oku. Kendi deponda i18n kuruyorsan ve aynı korumaları istiyorsan, depoyu globalize.now'da bağla, dönüşüm uygulamada bir kez çalışır. npx skills add globalize-now/globalize-skills, kodunun yanına kurulan Skill'ler için dokümante ettiğimiz giriş noktası. Dürüst kapanış: kendi ürünümüzü kendimiz kullandık, çirkin hatalar bulduk, politikayı yazdık ve bir kapı ekledik. Her çok dilli lansmanın karşılaması gereken çıta bu.
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