Isi kandungan:

Bagaimanakah anda menyediakan dokumentasi teknikal?
Bagaimanakah anda menyediakan dokumentasi teknikal?

Video: Bagaimanakah anda menyediakan dokumentasi teknikal?

Video: Bagaimanakah anda menyediakan dokumentasi teknikal?
Video: How to Work with Technical Writers - Google - SRECon2017 2024, November
Anonim

Menulis untuk Khalayak Anda: 6 Langkah untuk Mencipta Dokumentasi Teknikal Yang Digunakan

  1. Perancangan. Ketahui tujuan dan skop projek sebelum anda bermula.
  2. Merangka. Mulakan dengan garis besar peringkat tinggi tentang semua topik yang akan dipelajari.
  3. Mengkaji semula.
  4. Mengkaji semula.
  5. Mengedit.
  6. Menerbitkan/Menyelenggara.

Secara ringkasnya, apakah yang perlu disertakan dalam dokumentasi teknikal?

Teknikal penulisan merangkumi pelbagai jenis dokumen. Ia termasuk arahan, ulasan, laporan, surat berita, pembentangan, halaman web, brosur, cadangan, surat, risalah, grafik, memo, siaran akhbar, buku panduan, spesifikasi, panduan gaya, agenda dan sebagainya.

Selain itu, bagaimanakah anda menyediakan dokumentasi untuk projek? Amalan Terbaik untuk Mendokumentasikan Projek Anda

  1. Sertakan fail README yang mengandungi.
  2. Benarkan penjejak isu untuk orang lain.
  3. Tulis dokumentasi API.
  4. Dokumenkan kod anda.
  5. Gunakan konvensyen pengekodan, seperti organisasi fail, ulasan, konvensyen penamaan, amalan pengaturcaraan, dsb.
  6. Sertakan maklumat untuk penyumbang.

Kedua, apakah itu mencipta dokumentasi teknikal?

Dokumentasi teknikal merujuk kepada mana-mana dokumen yang menerangkan penggunaan, kefungsian, penciptaan, atau seni bina sesuatu produk. Anggaplah ia sebagai panduan "cara" untuk pengguna anda, pekerja baharu, pentadbir dan sesiapa sahaja yang perlu mengetahui cara produk anda berfungsi.

Bagaimanakah saya boleh meningkatkan kemahiran dokumentasi saya?

Jadi, berikut ialah beberapa petua ringkas dan pantas untuk membantu anda dan pasukan anda menambah baik dokumentasi anda dengan segera

  1. Petua 1) Berhenti dengan Suara Pasif.
  2. Petua 2) Gunakan Visual Mudah untuk Melibatkan Pembaca anda.
  3. Petua 3) Gunakan Tajuk dan Peluru Hebat.
  4. Petua 4) Jinakkan Akronim dan Perkataan Buzz anda.
  5. Petua 5) Gunakan Standard Reperformance.

Disyorkan: