Teknik Dokumentasi Aplikasi

PART 5 

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

STYLE

Dalam penggunaan kalimat panjang yang harus diperhatikan adalah :

·         Sebuah informasi harus mudah dimengerti oleh pembaca

·         menggunakan kalimat singkat dan sederhana

·         mencoba untuk menjaga antara 13-21 kata per kalimat

dan juga dalam menggunakan penomoran :

1.    Nomor dalam teks

2.    Bab, Bagian, Halaman

3.    Angka yang terkait

Yang harus di perhatikan juga yaitu:

Kapan kata tersebut harus menggunakan Bold,  Italics dan Underline

istilah teknis

·         menyediakan Glosari istilah teknis dalam kurung di dalam teks. Maksudnya adalah misalnya didalam penulisan terdapat kata-kata atau istilah yang tidak umum maka istilah tersebut harus di artikan dengan cara memberikan tanda kurung setelah istilah tersebut. Missal :

Network (jaringan), paradigm (pemikiran) dll.

·         menyediakan daftar istilah, ussually pada akhir manual. Maksudnya menyediakan daftar istilah yang terdapat dalam buku tersebut. Seperti Daftar Index.

·         mengekspresikan ide-ide dalam kata-kata lain

Menggunakan Kata "must", "should", "can", "may"

1.      Must : bahwa tindakan tersebut wajib

2.      Should : bahwa dianjurkan

3.      Can : menunjukkan kemampuan

4.      May : ijin atau kemungkinan

akronim dan singkatan

1.      “ Central Procesing Unit (CPU)

2.      “ Mr untuk Mister

3.      “ Information Of Schol (IOS)