Kami menjual infrastruktur terjemahan. Situs marketing kami sendiri tersedia dalam lima bahasa. Saat mengaudit JSON yang benar-benar kami sajikan, temuan pertamanya bukan soal nada bahasa. Yang ditemukan adalah satu karakter yang salah di dalam kata majemuk bahasa Jerman yang sekilas tampak baik-baik saja: huruf Sirilik di tempat yang seharusnya huruf Latin. Kata itu tampak wajar, seperti entri glosarium yang sah, sampai kamu memeriksa code point-nya. Kalau terjemahan kami sendiri rusak, mengapa orang lain harus memercayai produknya?
Lima kegagalan yang seharusnya tidak pernah dirilis
Huruf Sirilik di teks UI bahasa Jerman. Satu baris glosarium pernah berisi campuran aksara: akhirannya tampak seperti “ar” Latin, padahal satu hurufnya bukan. Penutur asli langsung menyadarinya. Spell check tidak.
**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.
Register terbalik di bahasa Jerman dan Prancis. Situs ini adalah tool untuk developer. Gaya bahasanya seharusnya sama dengan cara engineer menulis di UI produk. Kami sempat merilis sapaan formal di seluruh de dan fr. Ini bukan masalah sepele. Artinya, jalur terjemahan default memilih register yang salah untuk seluruh permukaan situs, bukan hanya segelintir string yang jarang muncul.
**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.
Mata uang tidak konsisten. Sumber bahasa Inggris menampilkan mata uang yang berbeda dari versi bahasa Jerman, yang menampilkan label bulanan. Kami tidak menagih harga berbeda untuk tiap negara, dan semua harga dalam EUR. JSON-nya menyiratkan hal sebaliknya.
**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.
False friend untuk “coding”. Di tiga bahasa, “coding environment” diterjemahkan dengan kata untuk encoding. FAQ-nya malah menyuruh orang tetap berada di “lingkungan encoding” mereka. Itu keliru dalam pembacaan apa pun atas produk ini.
**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” terbaca sebagai pengiriman paket. Teks bahasa Jerman dan Italia memakai kata kerja yang diasosiasikan orang dengan paket, bukan dengan merilis software. Sumber Inggrisnya sama, tetapi medan kosakatanya salah. Itu berasal dari saran mesin yang tidak dikoreksi, bukan dari pilihan gaya yang disengaja.
**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.
Mengapa terjemahan otomatis bisa menyimpang
Ini bukan keluhan terhadap penerjemah. Sebagian besar isi situs memang tidak pernah melewati pemeriksaan manusia per string. Model serbaguna cenderung memakai register formal karena begitulah wujud teks dwibahasa berskala besar di web. Model juga mencampur huruf yang mirip bentuknya lintas aksara ketika tujuannya adalah “karakter yang terlihat masuk akal”, bukan “aksara yang benar”. Tanpa glosarium, pilihan kata bergeser antar-kunci yang berdekatan. Tanpa aturan mata uang, model mengarang simbol lokal yang tampak wajar. Tanpa pemeriksaan domain, encoding dan coding bertabrakan. Itulah jenis kegagalan yang ingin kami kurangi. Situs kami sendiri tetap merilisnya sampai kami mengaudit seperti yang akan dilakukan pelanggan.
Yang kami bangun setelah pembersihan
Sekadar mengedit teks sekali jalan bukanlah sistem. Bagian yang tahan lama adalah satu file kebijakan kecil yang bisa dijadikan acuan seluruh tim (dan setiap batch terjemahan otomatis di masa depan), ditambah skrip verifikasi yang bisa dijalankan sebelum merge.
Kebijakan. i18n/LOCALIZATION_POLICY.md mencatat register per bahasa, harga hanya dalam USD di JSON, keputusan kata serapan (misalnya mempertahankan vibe coders dalam bahasa Inggris), aturan false friend untuk coding vs encoding, dan tipografi untuk literal inline. Isinya sengaja singkat. Aturan yang tidak ditulis tidak akan disimpulkan model secara konsisten.
## Currency
- USD only in all locales. Use {monthlyPrice} and {overageRate} placeholders…
## False friends
- Coding environment is not encoding: Spanish desarrollo / Italian sviluppo / German Entwicklung…
Verifikasi. scripts/verify-translations.sh memeriksa huruf Sirilik di file bahasa beraksara Latin, simbol euro, substring false friend lama, dan kesesuaian placeholder harga terhadap messages/en.json. Pemeriksaan opsional memakai ripgrep jika terpasang. Skrip ini hanya batas bawah, bukan batas atas. Fungsinya agar “sudah kami perbaiki sekali” tidak pudar diam-diam pada edit massal berikutnya.
Perbaikan di kode, bukan tebakan JSON lagi. Kami memusatkan nominal USD yang ditampilkan di lib/pricing.ts dan menyambungkan formatUsdPerMonth serta formatUsdOveragePer1k ke homepage dan FAQ supaya file bahasa berhenti mengarang angka. Bug-nya bukan hanya string yang salah. Bug-nya adalah belum adanya kebijakan dan formatter sebelum skalanya membesar.
Yang layak kamu tiru untuk i18n berbantuan AI
Kalau kamu membuat terjemahan dengan model, register adalah parameter dengan variasi terbesar. Kunci per locale sebelum menambah bahasa lain. Kunci mata uang di dalam kode, bukan di dalam teks. Kunci token merek dan istilah teknis developer. Jalankan pemeriksaan otomatis yang menggagalkan batch, bukan "nanti kita cek manual". "Nanti" tidak pernah mencapai standar kualitas yang sama seperti pengerjaan pertama.
Untuk cerita arsitektur di balik audit ini, baca Cara Melokalisasi Aplikasi Buatan AI dan perbandingan tooling di globalize.now vs Lokalise vs Crowdin. Kalau kamu sedang menyiapkan i18n di repo sendiri dan ingin guardrail yang sama, hubungkan repositori di globalize.now dan konversi berjalan sekali, di dalam aplikasi; npx skills add globalize-now/globalize-skills adalah titik masuk yang kami dokumentasikan untuk skill yang terpasang di samping kodemu. Penutup yang jujur: kami memakai produk kami sendiri, menemukan bug yang buruk, menulis kebijakan, dan menambahkan gerbang. Itulah standar yang kami inginkan untuk setiap peluncuran multibahasa.
globalize.now mengubah teks hardcode di aplikasimu menjadi file locale yang siap diterjemahkan, lalu menjaganya tetap diperbarui setiap kali kamu rilis.
Coba globalize.now gratis