Bagaimana Menulis Manual Teknikal Dari Scratch

Anonim

Menulis buku panduan teknikal adalah tugas mudah yang melibatkan langkah-langkah mengatur dan membuat kata-kata yang ringkas dan ringkas. Matlamat manual teknikal adalah untuk memberi maklumat tentang bagaimana untuk melaksanakan operasi dalam jumlah paling sedikit langkah dan dengan cara yang paling jelas. Manual teknikal sering melibatkan kolaborasi ramai orang, termasuk pakar subjek, editor dan penulis teknikal. Memandangkan manual teknikal juga boleh menjalani semakan dan kemas kini yang berterusan, komunikasi antara pihak yang terlibat adalah penting untuk pembangunan manual.

Tentukan gaya manual teknikal dengan sama ada mencipta panduan gaya ringkas atau dengan mengikuti panduan gaya yang sedia ada, seperti Panduan Gaya Ringkas untuk Manual Teknikal Microsoft. Panduan gaya akan membantu dalam mencipta rangka manual dan memastikan konsistensi.

Tulis langkah-langkah untuk prosedur yang bermula dengan kata kerja. Jika perundingan diperlukan untuk menulis langkah-langkah, temubual dan bertanya soalan ahli-ahli subjek. Ini akan memastikan kesahihan prosedur; jika tidak, langkah-langkah mungkin tidak logik dan / atau tidak boleh dipatuhi. Langkah-langkah perlu diperintahkan secara logik dan dipisahkan ke dalam bab atau bahagian logik.

Tambah grafik dan ilustrasi kepada langkah-langkah yang memerlukannya. Ingat untuk menambah penomboran angka dan tajuk untuk setiap grafik / ilustrasi.

Buat jadual kandungan dan indeks untuk rujukan mudah.

Tambah log perubahan atau kunci kemas kini yang merekodkan setiap perubahan dan kemas kini ke manual untuk semakan dan siaran masa depan. Manual teknikal harus selalu diedit oleh seseorang selain penulis teknikal, lebih disukai oleh editor profesional.