Cara menulis instruksi yang langsung dipahami sejak pertama dibaca

Pelanggan menghubungi tim dukungan, karyawan baru menanyakan hal yang sama berulang kali, dan tugas yang dikerjakan “sesuai instruksi” tetap saja salah. Biasanya instruksinya sendiri yang bermasalah: ditulis oleh orang yang terlalu paham tugasnya sampai tidak melihat di mana pemula tersesat. Berikut tujuh aturan agar instruksi langsung berhasil sejak pertama dibaca, baik berupa panduan pengguna, artikel pusat bantuan, maupun SOP kerja.

1. Satu tugas per instruksi

“Cara mengatur akun Anda” terlalu luas. “Cara mengganti kata sandi” dan “Cara menambahkan anggota tim” adalah dua instruksi terpisah. Pembaca mencari satu tugas, menemukannya, mengerjakannya, lalu pergi.

2. Mulai dengan hasil dan apa yang dibutuhkan

Di dua baris pertama, sebutkan apa yang akan dicapai pembaca dan apa yang perlu mereka siapkan sebelum mulai: hak akses, sebuah file, kata sandi, sepuluh menit waktu luang. Tidak ada yang lebih menjengkelkan daripada baru tahu di langkah 7 bahwa ada yang seharusnya disiapkan sejak awal.

3. Langkah bernomor, satu tindakan per langkah

Setiap langkah adalah satu tindakan, diawali kata kerja: “Buka Pengaturan”, “Klik Simpan”. Jika sebuah langkah mengandung “lalu”, berarti itu dua langkah. Nomor membantu pembaca tahu sampai mana mereka, dan memudahkan tim dukungan berkata “lihat langkah 4”.

4. Pakai kata-kata pembaca, bukan kata-kata Anda

Tulis nama tombol dan menu persis seperti yang dilihat pembaca di layar. Hindari istilah internal dan singkatan; jika sebuah istilah tidak bisa dihindari, jelaskan saat pertama kali muncul.

5. Tunjukkan apa yang seharusnya terjadi

Setelah langkah penting, jelaskan hasilnya: “Muncul pesan hijau: Tersimpan”. Pembaca tahu mereka berada di jalur yang benar, dan langsung sadar saat ada yang salah.

6. Peringatan sebelum langkahnya, bukan sesudahnya

“Sebelum mengklik Hapus, ekspor data Anda: data yang sudah dihapus tidak bisa dipulihkan.” Peringatan yang diletakkan setelah langkahnya datang terlambat.

7. Uji pada orang baru

Berikan instruksi kepada orang yang belum pernah mengerjakan tugas itu, lalu amati tanpa membantu. Setiap titik tempat mereka ragu, bertanya, atau melakukan kesalahan adalah bagian yang perlu ditulis ulang. Lima menit pengujian menemukan lebih banyak masalah daripada satu jam membaca ulang.

Gambar dan struktur

• Tangkapan layar untuk langkah di layar, dengan tombol yang tepat ditandai; perbarui saat tampilan antarmuka berubah.
• Subjudul untuk prosedur yang panjang, agar pembaca bisa langsung melompat ke bagian yang dibutuhkan.
• Bagian “Bagaimana jika” di akhir untuk masalah yang sering terjadi: “Jika Anda tidak menerima email, periksa folder spam”.

Ringkasnya

Satu tugas, hasil dan persyaratan di awal, langkah bernomor dengan satu tindakan, kata-kata pembaca, hasil yang diharapkan, peringatan tepat waktu, dan uji pada orang sungguhan. Jika Anda butuh panduan, kumpulan artikel bantuan, atau SOP kerja yang ditulis untuk Anda, pesan panduan pengguna dan SOP: Anda menjelaskan produk atau prosesnya, lalu menerima instruksi yang jelas dan terstruktur. Pembayaran baru dicairkan setelah Anda menerima hasil kerja.