Mulai dokumen antarmuka lintas bahasa dengan definisi bidang: nama, jenis, unit, rentang, dan arti nilai nol dan hilang. Bedakan pengidentifikasi protokol dari penjelasan pembaca. Kecuali definisi antarmuka mengizinkannya, jangan mengubah pengidentifikasi bidang, nilai enumerasi, atau kode kesalahan saat menerjemahkan bahasa alami.
Simpan versi dan pemetaan untuk perubahan
Ketika arti parameter, default, penanganan kesalahan, atau struktur berubah, catat versi antarmuka dan aturan migrasi. Tautkan dokumen yang dilokalkan ke versi yang sama dan tandai bagian yang belum diperbarui. Simpan definisi, revisi, dan contoh sebelumnya untuk mencegah tercampurnya instruksi lama dan baru.
Periksa contoh terhadap antarmuka sebenarnya
Parsing permintaan dan tanggapan dalam lingkungan yang disepakati. Periksa bidang, nilai, dan cabang kesalahan. Gunakan pengidentifikasi stabil untuk menghubungkan penjelasan kesalahan yang dilokalkan. Periksa parameter yang hilang, nilai tidak valid, dan versi yang tidak didukung. Laporkan contoh yang diterjemahkan sebagai terverifikasi hanya setelah melakukan pemeriksaan terkait.
Periksa bahasa dan arah teks secara bersamaan
Panduan internasionalisasi W3C membahas informasi arah bahasa dan teks untuk pesan bahasa alami. Bedakan penjelasan yang dapat dibaca dari pengidentifikasi program. Periksa teks dua arah, cuplikan kode, dan presentasi nomor. Pertahankan hasil rendering dan parsing. Tata letak yang dapat dibaca tidak menggantikan verifikasi fungsi protokol.
Melihat Panduan internasionalisasi W3C.