Blog Metlivi

Cara Memeriksa Ketepatan Istilah Teknis, Kapitalisasi, dan Label Terjemahan

Saat meninjau dokumentasi teknis, periksa setiap istilah berdasarkan tabel istilah yang eksplisit daripada mengandalkan ingatan atau satu aturan kapitalisasi saja. Catat bentuk yang disetujui, ejaan dan kapitalisasi huruf yang harus dilihat pembaca, varian yang dapat diterima, kode literal atau pengidentifikasi API, serta terjemahan apa pun yang masih menunggu keputusan. Kemudian lakukan uji baca (proofread) pada teks prosa, label antarmuka, dan pengidentifikasi sebagai hal-hal yang terpisah. Metode ini menangkap istilah yang tidak konsisten sekaligus mempertahankan nama dan kode yang harus tetap persis sama.

30 September 2026Waktu baca 4 mntEstetika sehari-hari dan ekspresi diriOleh Metlivi Editorial Team

Buka Produk Kembali ke blog

Bagian 1

Mengapa satu aturan kapitalisasi tidak bisa menyelesaikan setiap istilah?

Panduan gaya penulisan menyediakan standar umum yang berguna, tetapi suatu produk atau ranah tertentu mungkin memiliki nama baku yang memerlukan perlakuan berbeda. Panduan pengembang Google merekomendasikan kapitalisasi standar bahasa Inggris Amerika dan format huruf kalimat (sentence case) untuk judul bab, daftar, dan tabel, sembari tetap mempertahankan nama produk resmi dan bentuk kode. Panduan Microsoft juga mendukung kapitalisasi gaya kalimat, tetapi secara eksplisit mencadangkan huruf kapital untuk kata benda khusus (proper nouns) seperti merek, produk, dan layanannya. Standar bersama ini merupakan titik awal, bukan bukti bahwa suatu istilah teknis bersifat generik. [Panduan kapitalisasi Google](https://developers.google.com/style/capitalization) [Panduan kapitalisasi Microsoft](https://learn.microsoft.com/en-us/style-guide/capitalization)

Daftar kata dapat menjawab pertanyaan yang berbeda dari sekadar halaman kapitalisasi umum: ejaan atau penggunaan mana yang lebih disukai oleh panduan editorial tertentu untuk istilah-istilah spesifik. Daftar kata Google, misalnya, mengarahkan pembaca ke kamus pilihannya untuk entri yang tidak dicakupnya dan membedakan panduan gaya penulisan dari pemeriksaan definisi teknis dalam dokumentasi resmi. Pemisahan tersebut sangat berguna: konsistensi editorial dan ketepatan teknis membutuhkan bukti dari sumber yang sesuai untuk masing-masing pertanyaan. [Daftar kata Google](https://developers.google.com/style/word-list)

Bagian 2

Apa saja yang perlu dimasukkan ke dalam tabel istilah uji baca?

Buat satu baris untuk setiap istilah yang berpotensi diubah secara tidak konsisten atau salah diterjemahkan. Contoh hipotetis ini menunjukkan kolom dan logika keputusan; “Sync token” beserta terjemahannya hanya sebagai ilustrasi, bukan klaim tentang produk nyata atau terminologi yang disetujui.

Tugas tabel ini adalah mencatat keputusan dan batasannya. Bentuk huruf kecil yang diizinkan jangan sampai secara diam-diam menjadi nama produk kedua; sebuah pengidentifikasi tidak boleh “dikoreksi” agar cocok dengan teks prosa; dan terjemahan yang belum tuntas harus tetap terlihat belum tuntas. Jika sumber resmi bertentangan dengan glosarium lokal, catat pertentangan tersebut dan sumber dari keputusan akhirnya, alih-alih menggabungkan bentuk-bentuk tersebut ke dalam daftar tanpa penjelasan.

Istilah dan cakupan — Konsep, area produk, dan audiens — Sync token; panduan pengaturan

Bentuk resmi dan bukti — Bentuk persis yang disetujui, sumber, dan versi atau tanggal pemeriksaan — Sync token; glosarium produk, versi 3

Bentuk tampilan — Ejaan dan kapitalisasi yang digunakan dalam prosa penjelasan dan label — Sync token

Varian yang diizinkan — Bentuk yang diperbolehkan dalam konteks tertentu, beserta alasannya — “sync token” dalam prosa umum, jika diizinkan oleh glosarium

Pengidentifikasi literal — Kode, API, perintah, atau string UI persis yang tidak boleh ditulis ulang — `syncToken` dalam respons API

Status terjemahan — Label lokal yang disetujui, bukti, penanggung jawab atau alur kerja, atau status belum terselesaikan — Belum selesai; peninjauan terjemahan diperlukan

Bagian 3

Bagaimana cara menentukan ejaan dan kapitalisasi yang ditampilkan?

Pertama, identifikasi apa yang dirujuk oleh istilah tersebut: konsep umum, nama merek atau produk, label UI, atau pengidentifikasi literal. Periksa dokumentasi produk atau glosarium yang relevan untuk melihat bentuk resminya. Kemudian terapkan aturan gaya publikasi target pada prosa umum, judul, dan label, dengan tetap mempertahankan pengecualian yang terdokumentasi untuk nama dan pengidentifikasi. Google menyarankan untuk menghindari kapitalisasi yang tidak perlu dan memperingatkan agar tidak menggunakan kapitalisasi semata untuk membedakan makna; Microsoft juga menyatakan untuk menggunakan huruf kecil kecuali untuk awal kalimat dan kata benda khusus dalam pendekatan gaya kalimatnya. [Panduan kapitalisasi Google](https://developers.google.com/style/capitalization) [Panduan kapitalisasi Microsoft](https://learn.microsoft.com/en-us/style-guide/capitalization)

Selanjutnya, bandingkan bentuk tersebut dengan daftar kata dan kamus organisasi target jika sesuai. Catat sumber dan versinya atau tanggal pemeriksaan agar editor lain dapat menelusuri kembali pilihan tersebut. Jangan menyimpulkan status resmi hanya dari ejaan berhuruf kapital yang terlihat menarik, hasil pencarian, atau terjemahan yang menyerupai istilah bahasa Inggris. Jika sumber tidak sejalan atau gagal menentukan bentuknya, tandai baris tersebut untuk diputuskan lebih lanjut daripada menyajikan tebakan sebagai terminologi yang sudah pasti.

Bagian 4

Bagaimana sebaiknya terjemahan dan label antarmuka diperiksa?

Perlakukan penerjemahan sebagai keputusan makna dan konteks, bukan sekadar konversi kapitalisasi secara mekanis. Sebuah label mungkin dibatasi oleh antarmuka, terminologi produk lokal yang sudah mapan, atau bentuk tata bahasa yang berbeda dalam bahasa target. Bandingkan calon istilah dengan materi lokal yang telah disetujui dan konteks saat pembaca akan menemukannya. Jika tidak ada bentuk lokal resmi yang tersedia, tandai terjemahan sebagai belum terselesaikan dan mintalah keputusan terminologi yang tepat; jangan mengarang padanan yang seolah-olah resmi.

Setelah istilah diputuskan, lakukan uji baca pada label yang sebenarnya di tempatnya. Periksa apakah kapitalisasi mengikuti aturan bahasa yang dipilih serta gaya produk atau gaya selingkung yang berlaku. Jaga agar label asli tetap terlihat dalam catatan istilah, berdampingan dengan sumber dan statusnya, sehingga penyuntingan di masa mendatang tidak salah mengira terjemahan sementara sebagai terjemahan yang disetujui. Jika label tersebut juga dirujuk dalam instruksi, pastikan prosa menyebutkan kata-kata yang persis sama dengan yang ada di layar.

Bagian 5

Bagaimana cara melindungi kode dan pengidentifikasi API?

Pisahkan string literal dari teks editorial sebelum mengubah kapitalisasi huruf. Bandingkan pengidentifikasi karakter demi karakter dengan referensi API, skema, kode, atau antarmuka yang relevan. Pertahankan garis bawah (underscore), kapitalisasi, spasi, dan tanda baca sesuai ketentuan sumbernya; normalisasi gaya penulisan hanya berlaku pada penjelasan di sekitarnya, bukan pada nilai literal. Panduan Google secara khusus mengizinkan bentuk huruf besar semua (all-caps) atau camel-case pada nama resmi atau saat merujuk pada kode yang menggunakannya. [Panduan kapitalisasi Google](https://developers.google.com/style/capitalization)

Pemeriksaan praktis dilakukan dengan menandai pengidentifikasi yang dilindungi di dalam tabel istilah, lalu memeriksa setiap kemunculannya terhadap referensi tersebut. Jika sebuah kalimat prosa menggunakan istilah berbentuk kode sebagai kata benda biasa, putuskan apakah perlu menjelaskannya dengan kata-kata yang ramah pembaca sembari tetap mempertahankan pengidentifikasi literal dalam format kode. Ketika definisi resminya sendiri tidak jelas, catat ketidakpastian tersebut; panduan gaya tidak dapat menetapkan perilaku API atau nama ruas (field) kanonik.

Bagian 6

Bagaimana urutan uji baca yang andal?

Urutan ini merupakan alat bantu uji baca, bukan terjemahan otomatis atau aturan kapitalisasi universal. Nilai lebihnya terletak pada kemampuannya membuat setiap keputusan editorial dapat ditinjau: bentuk apa yang dipilih, dari mana asalnya, di mana penerapannya, dan apa yang masih memerlukan keputusan. Untuk dokumen pendek, tabel yang ringkas mungkin sudah cukup; untuk kumpulan terminologi yang besar, pertahankan kolom yang sama dalam alur kerja glosarium yang telah ditetapkan tim.

**Kumpulkan:** Identifikasi istilah teknis yang berulang, nama produk, label, istilah terjemahan, dan pengidentifikasi dalam materi yang sedang ditinjau.

**Verifikasi:** Konsultasikan dokumentasi resmi yang berlaku, glosarium, daftar kata, dan panduan gaya penulisan. Catat versi atau tanggal sumber jika tersedia.

**Putuskan:** Isi bentuk tampilan yang disetujui pada tabel, varian yang diizinkan, dan pengidentifikasi yang dilindungi. Tandai perbedaan pendapat dan terjemahan yang belum lengkap sebagai belum terselesaikan.

**Terapkan:** Sunting prosa biasa dan judul secara konsisten, sembari mempertahankan nama resmi, kutipan langsung, dan pengidentifikasi literal.

**Periksa ulang:** Cari setiap varian yang tercatat dan setiap pengidentifikasi yang dilindungi di seluruh dokumen. Pastikan setiap kemunculan sesuai dengan konteks yang dinyatakan, lalu selesaikan atau eskalasikan baris-baris yang masih terbuka sebelum menyatakan pemeriksaan terminologi selesai.

Bacaan terkait