T. Dokumentasi Aplikasi Part 5

Pada pertemuan 5 ini membahas tentang Style pada teknik penulisan aplikasi.

Controlled English

·         Gunakan tata bahasa yang benar

·         Bahasanya yang jelas

·         Kata-katanya harus sama (konsisten)

·         Apakah kalimat menyatakan pernyataan, kondisi kalimat, pertanyaan atau instruksi harus diperhatikan

Sentence Length

·         13(tiga belas) sampai 21(dua puluh satu) kata dalam satu kalimat

·         Gunakan kata-kata yang memang perlu dipakai

·         Kalimat mudah untuk dipahami dalam perolehan informasi

Clarity

·         Tidak membuat orang bingung(jelas, akurat, konsisten)

Pompous Style

·         Cara yang paling sederhana, tidak usah terlalu rumit

Jargon and Technical Terms

·         Ada pengekspresian ide pada kumpulan kata yang dibuat

·         Ada index

·         Ada glossary

Variety  and Inconsistency

·         Orang menjadi bingung karena ketidakkonsistenan sehingga perlu diperhatikan

Penggunaan Number (harus konsisten)

·         Number di dalam kalimat, ex: 2(dua)………………..

·         Penggunaan decimal harus ditentukkan

·         Apabila bagian harus romawi

·         Format tanggal harus diperhatikan

·         Format Waktu (Times) harus diperhatikan

·         Format nomor telepon juga harus ditentukan

Highlighting

·         Font bisa tebal (B)

·         Font bisa miring (I)

·         Font bisa garis bawah (U)

Capitalisation

·         Huruf Besar

·         Huruf Kecil

·         Huruf Awal Kapital

Colloquialism and Slang

·         Tetap pergunakan bahasa yang akrab tetapi tidak slang.

Humour

·         Menghibur (boleh memakai gambar lucu asalkan bukan gambar yang punya kesan negatif)

Using “He” or “She”

·         Menggunakan kata ganti orang, ex: Anda

Pemilihan kata: Bisa, Dapat, Mungkin itu ada pilihannya

Penggunaan Kata Singkatan ex: The Central Processing Unit (CPU)

Penggunaan tanda baca harus diperhatikan