T. Dokumentasi Aplikasi Part 4

Untuk membuat daftar yang dibuat perlu diperhatikan info apa saja yang dibutuhkan. Analisis membutuhkan data, data diperoleh dengan cara melakukan survey. Hal-hal yang perlu ditanyakan pada pembaca (bias cari data pada badan survey/statistik) sebagai berikut:

·   Pengalaman sebelumnya dari pembaca dalam penggunaan sebuah produk (evaluasi)

·   Apa subject pengetahuan utama pembaca.

·   Daftar apa saja yang ada pada perusahaan.

·   Indikator apa saja yang dibutuhkan oleh pembaca.

·   Indikator apa saja yang telah ada tetapi tidak diperlukan (perlu dievaluasi kembali apakah user masih perlu atau tidak).

·   Profil (apakah kita tahu tentang info sesuatu itu kita peroleh dari siapa).

Rules

·         editor harus membaca detail oleh dokumentator(dikoreksi).

·         direview kembali berulang-ulang.

Chapter (Heading 1)

·         Di buku harus ada chapter, minimal satu chapter (untuk menjelaskan garis besar).

·         ada index.

·         Satu halaman kurang tetapi 50 halaman terlalu panjang sehingga antara 1 s/d 50 halaman.

·         Ada relasi untuk bahan.

·         Memungkinkan sebuah buku ada chapter tetapi harus ada judulnya.

Sections and Subsections (Heading 2 dan 3)

·         Breakdown dari yang pertama (chapter).

·         Seharusnya minimal ada satu kegiatan.

Paragraph

·         Kalimat utama yang mendukung dari ide.

·         Jangan menggunakan satu kalimat dalam satu paragraph, paling tidak ada dua atau tiga minimal.

·         Beri jarak.

·         Jangan memisahkan kalimat paragraph dengan page breaks.

Appendices

·         Daftar kata.

·         Menjelaskan informasi berdasarkan huruf depan.

Headings

·         Pembaca ingin melihat ide ditampilkan penulis.

·         Harus sesuai dengan isi.

·         Lebih relevan terhadap isi.

·         Untuk pemilihan kata (penulisan) harus konsisten.

Cautions and Warnings : petunjuk dan pemakaian (peringatan)

Note: catatan khusus

Cross References: dapat melihat detailnya dari tempat lain

Text Formats: tanda penghubung, list angka, dialog(beberapa pertanyaan), keyword list (daftar kata kunci)

Perbedaan bullets & number yaitu bullets bias diacak dan masih belum tahu jumlahnya tetap apabila number harus urut dan tahu jumlahnya.