Resume TDA Pertemuan 5

Teknik Penulisan Aplikasi(STYLE)

1.  Menggunakan tipe kalimat yang benar beserta struktur nya

     2.   Dalam penulisan dokumentasi harus Jelas, akurat, singkat.

     3.   Gunakan bahasa Inggris umum dalam penulisan dokumentasi (Bila Perlu)

     4.   Panjang Kalimat

• Mudah dipahami.
• Menggunakan kalimat yang simpel.
• Usahakan 1 kalimat mempunyai 13 - 21 kata.
• Hindarkan dari kata yang tak perlu.

    5.   Penomeran

• Nomor berupa teks.
• Bab, Sub-Bab, Halaman, dan nomor
• Desimal
• Angka unit.
• Tanggal
• Jam.
• Nomor telepon.

    6.   Bahasa dan Istilah

• Menyediakan kamus istilah-istilah di dalam kata

• Menyediakan glosarium istilah, biasanya terletak pada akhir buku

• Mengekspresikan ide-ide dalam kata-kata lain

    7.   Penulisan Huruf

• Bold : penulisan huruf mengunakan bold biasanya digunakan untuk judul bab atau subbab.

• Italics : penulisan huruf menggunakan italics biasanya digunakan untuk bahasa asing.

• Underlining

Resume TDA Pertemuan 4

Penulisan Pertama

Aturan:

• Selalu menjaga hubungan dengan Editor.
• Tinjau secara terus menerus.
• Belajarlah dari kesalahan.

Paragraf

• Kumpulan dari kalimat - kalimat yang membentuk suatu ide utama
• Jangan menggunakan banyak paragraf kecil (beberapa kalimat saja)
• Jangan membagi paragraf pada halaman terpisah
• Selalu menempatkan line kosong (spasi) antar paragraf

Syarat sebuah paragraf

• Kalimat Pokok : Biasanya diletakkan pada awal paragraf, tetapi bisa juga diletakkan pada bagian tengah maupun akhir paragraf. Kalimat pokok adalah kalimat yang inti dari ide atau gagasan dari sebuah paragraf. Biasanya berisi suatu pernyataan yang nantinya akan dijelaskan lebih lanjut oleh kalimat lainnya dalam bentuk kalimat penjelas.
• Kalimat Penjelas : Kalimat penjelas adalah kalimat yang memberikan penjelasan tambahan atau detail rincian dari kalimat pokok suatu paragraf. 

Lampiran

• Menyediakan informasi yang berhubungan dengan buku
• Menggunakan standar dan struktur yang sama dengan bab

Judul

• Digunakan pembaca untuk mendapat ide apa yang akan mereka dapatkan
• Hanya diperbolehkan 3 tingkatan (Bab, Bagian, dan Sub bagian)
• Harus relevan dengan isinya.
• Jangan menulis judul lebih dari satu baris.
• Selalu menempatkan beberapa tulisan antara judul bagian dengan subbagian pertama.
• Konsisten dalam pemilihan kata.

Resume TDA Pertemuan 3

Tipe - Tipe Buku

Kualitas di dalam teknis publikasi

Kualitas dalam teknik publikasi adalah relatif

• Kualitas dalam teknik publikasi tergantung pada persepsi seorang pengguna (pembaca)
• Kesesuaian dengan persyaratan (Crosby, 1979).

Syarat dari teknik publikasi dari sebuah buku:

• Memberikan nilai/informasi yang baik : maksudnya adalah bahwa darisebuah buku yang dibaca dapat memberikan suatu nilai yang bermanfaat untuk pembacanya.
• Informasi yang digunakan akurat : maksudnya adalah bahwa informasi yang ada di dalam buku tersebut memang akurat kebenarannya tidak direkayasa.
• Customer tidak banyak tanya : maksudnya adalah bahwa buku yang dipublikasikan dapat mempermudah customer dalam membaca,jika ada kata-kata yang sulit diterjemahkan maka penulis dapat memberikan keterangan dari kata-kata itu.
• Pengeluaran yang dikeluarkan dengan rendah :  
• Memberikan batasan yang rendah terhadap orang yang tidak suka membaca : maksudnya adalah bahwa ada sebagian orang yang melakukan kegiatan membaca itu sulit menerima isi tulisan dari buku tersebut sehingga dari para penulis memberikan batasan yang sesuai dengan tingkat kepahaman seseorang dalam mengerti sebuah buku tersebut.
• Dapat diperlukan/membantu untuk komunitas
• Mengurangi biaya dukungan dari customer support
• Tidak banyak turun lapangan tetapi banyak memmbaca buku petunjuk
• meningkatkan penjualan

6 langkah dalam proses menulis :

• Analisa pembaca.
• Membuat ringkasan.
• Mebuat rincian.
• Memilih gaya dan format yang akan digunakan.
• Menulis buku manual.
• Mencoba buku manual.

4 macam buku manual yang berguna bagi pengguna aplikasi / software

• Pengantar panduan.
• Panduan pelatihan.
• Panduan user.
• Panduan referensi.