Panduan gaya sering berisi kata seperti profesional, ramah, dan informatif. Penulis tetap dapat menghasilkan naskah yang sangat berbeda karena kata-kata itu belum menjelaskan keputusan yang harus diambil saat menulis.
Panduan editorial yang bisa dipakai perlu menunjukkan aturan, alasan, dan contoh. Ia membantu penulis memilih istilah, menyatakan batas klaim, serta menyusun petunjuk secara konsisten. Saya menyarankan membangunnya dari revisi nyata yang berulang.
Tujuannya bukan menyeragamkan semua kalimat. Yang ingin kita jaga adalah pengalaman pembaca: istilah tidak berubah tanpa alasan, klaim memiliki dasar, dan langkah penting tidak hilang ketika penulis berganti.
Lengkapi aturan bahasa dengan lembar pemeriksaan fakta dan sumber supaya konsistensi gaya tetap didukung bukti yang dapat ditelusuri.
Mulai dari keputusan yang paling sering diperdebatkan
Ambil beberapa naskah yang sudah diedit. Tandai keputusan berulang, misalnya apakah memakai “unduh” atau “download”, bagaimana menulis label tombol, dan kapan contoh harus diberi label ilustrasi.
Kelompokkan persoalan berdasarkan dampaknya. Kesalahan nama fitur dapat membuat tutorial tidak bisa diikuti. Perbedaan gaya tanda baca mungkin hanya membutuhkan penyelarasan ringan. Jangan memberi kedua masalah itu bobot yang sama.
Buat daftar awal dengan format berikut:
| Persoalan | Keputusan | Alasan | Contoh |
|---|---|---|---|
| Label antarmuka | Ikuti teks yang terlihat pada produk | Pembaca bisa mencocokkan instruksi | Pilih Export, lalu tentukan format |
| Akronim | Jelaskan pada penggunaan pertama yang relevan | Pembaca baru tidak perlu menebak | Sebut istilah lengkap sebelum singkatan |
| Angka hasil | Cantumkan dasar dan cakupannya | Contoh tidak dianggap hasil nyata | “Dalam simulasi ini…” |
| Batas fitur | Letakkan dekat klaim kemampuan | Pembaca melihat syarat sebelum bertindak | “Tersedia pada paket yang disebut…” |
Aturan seperti ini dapat diterapkan. “Tulis lebih bagus” tidak memberi penulis keputusan yang jelas.
Bedakan suara brand dan nada situasi
Suara brand menjelaskan cara umum kamu berbicara. Nada menyesuaikan keadaan pembaca. Halaman perayaan komunitas dapat lebih ringan daripada petunjuk memperbaiki berkas yang gagal terbuka.
Mailchimp membedakan voice yang relatif konsisten dan tone yang menyesuaikan situasi pembaca. Contoh itu berguna untuk memahami struktur panduan, tanpa harus meniru kepribadian brand mereka. Panduan voice dan tone Mailchimp.
Tuliskan pasangan situasi dan respons. Saat pembaca bingung, gunakan instruksi langsung dan jelaskan hasil yang diharapkan. Saat hasil belum diketahui, sebutkan ketidakpastian. Hindari humor yang membuat kegagalan pembaca terasa diremehkan.
Tambahkan contoh sebelum dan sesudah. “Tenang, masalah sepele ini pasti selesai” dapat diganti menjadi “Periksa format berkas terlebih dahulu. Jika formatnya didukung tetapi tetap gagal, lanjutkan ke pemeriksaan izin akses.” Kalimat kedua menyediakan langkah tanpa janji palsu.
Buat aturan bukti yang melindungi makna
Panduan gaya perlu mengatur cara menyatakan sesuatu, termasuk batas pengetahuan. Tentukan bagaimana membedakan pengujian langsung, dokumentasi, interpretasi, dan contoh rekaan.
Untuk tutorial, catat kondisi pengujian yang relevan. Untuk perbandingan produk, jangan menyebut fitur pesaing tidak tersedia hanya karena pemeriksa belum menemukannya. Untuk contoh angka, nyatakan apakah angka merupakan simulasi atau hasil pengamatan.
Aturan bukti dapat berbentuk singkat:
- Klaim kemampuan harus didukung pemeriksaan atau sumber yang relevan.
- Pernyataan pengalaman hanya ditulis jika pengalaman tersebut benar-benar ada.
- Ketidakpastian tidak dihapus ketika paragraf diringkas menjadi judul.
- Sumber yang bertentangan dicatat dan diperiksa sebelum memilih kesimpulan.
Panduan ini mengarahkan editor ke masalah yang harus diselesaikan. Ia tidak menggantikan pemeriksaan fakta pada setiap artikel.
Simpan istilah pembaca beserta konteksnya
Bahasa pelanggan dapat membantu penulis menjelaskan tugas dengan istilah yang dikenali. Namun, daftar kata tanpa konteks dapat membuat brand meniru slang secara berlebihan atau mengubah keluhan menjadi janji produk.
Simpan jejak singkat berikut. Isian pada contoh ini seluruhnya ilustratif:
| Ungkapan | Konteks | Arti yang perlu diperiksa | Penggunaan editorial |
|---|---|---|---|
| “File-nya tidak kebuka” | Penerima memakai ponsel | Format atau akses belum diketahui | Pembuka masalah, lalu bedakan penyebab |
| “Yang final yang mana?” | Beberapa lampiran revisi | Penamaan versi membingungkan | Jelaskan cara mengenali versi yang disetujui |
| “Biar tinggal pakai” | Mencari template | Bisa berarti tanpa konfigurasi | Nyatakan langkah awal yang tetap diperlukan |
Pertahankan perbedaan antara pengamatan dan tafsiran. Panduan GOV.UK juga memisahkan catatan tentang apa yang dilihat atau didengar dari temuan hasil analisis. Cara menganalisis sesi riset pengguna.
Kutipan privat perlu diperlakukan sesuai izin dan konteks penggunaannya. Untuk kamus internal, ringkasan kebutuhan sering cukup tanpa menyimpan identitas orang. Jangan menampilkan kalimat rekaan sebagai ucapan pelanggan nyata.
Sesuaikan aturan dengan jenis halaman
Tutorial memerlukan prasyarat, langkah, hasil yang diharapkan, dan jalur ketika gagal. Halaman perbandingan memerlukan kriteria yang sebanding. Artikel opini memerlukan pemisahan penilaian dari fakta pendukung.
Jangan memaksa satu urutan heading untuk semua bentuk tulisan. Buat daftar kelengkapan per jenis halaman, lalu biarkan penulis memilih struktur yang paling membantu tugas pembaca.
Demikian pula dengan keyword. Panduan dapat meminta istilah utama yang jelas dan wajar pada judul serta bagian relevan. Ia tidak perlu menetapkan pengulangan persis pada setiap paragraf atau persentase kata kunci sebagai ukuran mutu.
Tentukan cara menyelesaikan pengecualian
Kasus baru akan muncul. Catat pertanyaan, pilihan yang dipertimbangkan, keputusan, alasan, dan pemilik keputusan. Jika keputusan hanya berlaku pada satu artikel, jangan langsung mengubahnya menjadi aturan seluruh situs.
Contohnya, nama fitur berbahasa Inggris dipertahankan karena antarmuka produk belum diterjemahkan. Itu tidak berarti semua istilah biasa harus menjadi bahasa Inggris. Ruang berlaku aturan perlu tertulis.
Berikan tanggal pembaruan dan ringkasan perubahan penting. Penulis tidak perlu membaca ulang seluruh dokumen hanya untuk menemukan satu istilah yang diganti. Hindari menyimpan beberapa salinan panduan tanpa penanda versi yang jelas.
Uji panduan dengan tugas edit yang sama
Berikan satu paragraf contoh kepada dua penulis. Minta keduanya menyunting menggunakan panduan, lalu jelaskan aturan yang dipakai. Perbedaan hasil membantu menemukan aturan yang masih kabur.
Jika keduanya memilih istilah berbeda tetapi makna tetap jelas, mungkin panduan memang memberi ruang gaya. Jika satu menghapus pengecualian penting, perjelas aturan bukti. Ukur pengulangan revisi yang sama, bukan seberapa mirip semua kalimat.
Panduan siap digunakan ketika penulis dapat mengambil keputusan tanpa terus menebak preferensi editor. Mulai dari masalah yang benar-benar berulang, uji contoh penerapannya, kemudian tambahkan aturan hanya ketika ada kebutuhan baru.
