Teknik Dokumentasi Aplikasi

Part 3
Pengajar :Ayuningtyas, S.Kom.,M.MT.,- MOS

THE TYPE OF BOOKKS

Untuk mencapai kualitas dalam publikasi teknis yang paling umum diterima untuk memastikan kualaitas dalam publikasi teknis adalah :

1. Mengatur Standart

Ø  Format dan tipografi

Ø  Gaya penulisan

Ø  Penggunaan istilah khusus

Ø  Ejaan dan singkatan

Ø  Publikasi organisasi

Ø  Organisasi perpustakaan

Ø  Publikasi proses pembangunan

2. Memperkejakan orang baik-baik
3. Menggunakan alat yang baik

Ada 6 langkah dalam prose menulis, diantaranya :

1. Menganalisa audiens
2. Membuat definisi rinci
3. Memilih gaya format yang akan digunakan
4. Menulis manual
5. Pengujian manual

Ada 4 macam panduan dalam penggunaan perangkat lunak

1. Introductory manuals

Ada dua kemungkinan  pada audiens :

Ø  Potensi pelanggan yang sedang mempertimbangkan apakah akan membeli produk.

Ø  Orang yang memiliki produk, tetapi tidak tahu apa-apa  tentang hal itu sebelumnya.

Tujuan :

Ø  Memberikan gambaran umum dari produk, menekankan manfaat yang bisa diperoleh dari menggunaknnya.

Ø  Menggambarkan fitur-fitur produk yang paling menarik bagi pembaca.

2. Training manuals

Tujuan :

Ø  Untuk pengguna baru, untuk membantu mereka untuk lebih mengetahui apa yang harus dilakukan.

Ø  Untuk memperkenalkan pengguna ke system atau produk

Ø  Memberikan kepada mereka kepercayaan diri.

3. User Manual

Tujuan :

Ø  Pengguna tingkat menengah

Ø  Memperkenalkan semua kemampuan pada system

Ø  Bagaimana dia dapat menggunakan produk  tersebut untuk melakukan apa yang dia inginkan

Ø  Menunjukkan bagaimana untuk mencapai hasil dengan produk.

Style

ð  Antara pelatihan dan referensi manual.

4. References manual

Tujuan :

Ø  Memiliki pengetahuan lebih banyak produk

Ø  Ingin mengetahui lebih

Ø  Menyediakan semua fakta dalam cara yang mudah untuk menemukan, tidak ambigu.

Style

ð  Memiliki indeks, lengkap dengan komprehensif