Tata bahasa: Indonesia
Aturan mekanis untuk tulisan berbahasa Indonesia. Dasarnya: janji merek resmi (hlm. 14) dan kebiasaan di 20.662 string UI produk.
Sapaan dan kata ganti
- Pembaca: "Anda", dengan A kapital. Janji merek resmi memakai "Anda", dan produk memakainya secara konsisten.
- Trusteeku: "Trusteeku" atau "kami". Jangan "kita" untuk menyebut perusahaan. "Kita" berarti pembaca ikut serta.
- Jangan sapaan akrab: kamu, kalian, sobat, kak, min.
- Di produk, subjek sering bisa dibuang: "Pilih vendor, lalu unggah lagi."
- "Bapak" atau "Ibu" hanya di percakapan langsung dan surat, bukan di antarmuka.
Satu bahasa per label
- Satu bahasa per kalimat. Satu bahasa per label.
- Istilah terkunci selalu ditulis apa adanya di kedua bahasa. Daftarnya di daftar-kata.md.
- Kata kerja tombol dalam bahasa Indonesia: Simpan, Batal, Kirim, Setujui, Hapus, Unggah, Unduh.
- Jangan campur dalam satu label. Contoh nyata di produk: "Save & duplikat". Tulis "Simpan & duplikat".
- Nama dokumen yang di produk memang berbahasa Inggris (Sales Order, Purchase Invoice) diperlakukan sebagai nama diri.
- Jangan tampilkan nama internal kepada pengguna: nama izin, nama status di basis data, istilah developer.
| Sebelum | Masalah |
|---|---|
| "Invariant SO ⇔ CONVERTED tidak konsisten" | Istilah developer dan nama status internal |
| "Minta izin post-journal ke administrator." | Nama izin internal. Tulis "wewenang memposting jurnal" |
Huruf kapital
- Sentence case untuk judul, tombol, menu, dan label: "Simpan sebagai draf", bukan "Simpan Sebagai Draf".
- Nama dokumen dan nama menu tetap kapital: Faktur Pajak, Sales Order, SPT Masa.
- Jangan huruf kapital semua untuk penekanan. Contoh nyata di produk: "periode TERKUNCI".
Angka, uang, tanggal
- Rupiah:
Rp 1.250.000. Titik untuk ribuan, koma untuk desimal, spasi setelah Rp. - Jangan menulis angka uang langsung di dalam string. Biarkan formatter produk yang menulis.
- Tanggal di tabel:
7 Okt 2026. Tanggal di kalimat:7 Oktober 2026. Jam:14:00 WIB. - Masa pajak:
Masa Oktober 2026. - Angka ditulis dengan angka, termasuk di bawah sepuluh: "3 faktur". Pengecualian: tulisan naratif di artikel.
- Persen menempel pada angka:
11%.
Tanda baca
- Tanpa tanda pisah panjang (—). Ganti dengan titik, koma, titik dua, atau tanda kurung. Ini penanda tulisan AI yang paling cepat dikenali pembaca.
- Tanpa tanda seru. Peringatan cukup kuat lewat warna dan ikon. Contoh nyata di produk: "Peringatan!".
- Tanpa elipsis untuk efek dramatis. Elipsis hanya untuk proses berjalan: "Mengirim ke Coretax…"
- Tanpa emoji di produk, email transaksional, dan dokumen. Di media sosial paling banyak satu, dan bukan pengganti kata.
- Titik di akhir kalimat lengkap. Tanpa titik untuk label, tombol, dan judul.
- Titik dua untuk memperkenalkan daftar atau nilai, bukan untuk judul bergaya "Topik: Penjelasan Panjang".
Cara mengganti tanda pisah panjang:
| Sebelum | Menjadi |
|---|---|
| "Kode KBLI harus 5 digit — contoh: 69200" | "Kode KBLI harus 5 digit. Contoh: 69200" |
| "Opsional — bisa diisi belakangan" | "Opsional. Bisa diisi belakangan." |
| "NPWP tersimpan terenkripsi — biarkan kosong untuk mempertahankan, atau isi untuk menggantinya." | "NPWP tersimpan terenkripsi. Biarkan kosong untuk mempertahankannya, atau isi untuk menggantinya." |
Kalimat
- Aktif lebih dulu. Pasif boleh ketika pelakunya sistem dan yang penting adalah objeknya: "Jurnal diposting."
- Positif lebih dulu: "Isi NPWP 16 digit", bukan "NPWP tidak boleh kurang dari 16 digit".
- Buang kata pengisi: "silakan" di tombol dan pesan error, "berhasil" di pesan sukses, "Anda dapat" di awal instruksi.
- Hindari bahasa surat dinas: dalam rangka, sehubungan dengan, adapun, guna. Pakai: untuk, karena.
- Teks bantuan paling banyak dua kalimat. Sisanya di tautan "Pelajari".