Resume Kuliah Teknik Dokumentasi Aplikasi - Pertemuan 4

DEFINING THE NEED FOR INFORMATION

Cara paling efektif untuk membangun publikasi yang baik tentu membutuhkan analisis

WRITING THE FIRST DRAFT

- Aturan (Rules):

·         Selalu menjaga hubungan dengan editor 

·         Tinjau secara terus menerus

·         Belajar dari kesalahan

- Bab (Chapter)

• Bagian informasi utama dalam buku
• Memudahkan pembaca mengenai apa yang mereka cari
• Materi apa saja yang terkait
• Bagian dari bab yang yang digunakan untuk memecah bagian menjadi beberapa yang lebih mudah dimengerti
• Bagian harus mencakup satu kegiatan

- Paragraf

Paragraf adalah suatu bagian dari bab pada sebuah karangan atau karya ilmiah yang mana cara penulisannya harus dimulai dengan baris baru. Paragraf dikenal juga dengan nama lain alinea. Paragraf dibuat dengan membuat kata pertama pada baris pertama masuk kedalam (geser ke sebelah kanan) beberapa ketukan atau spasi

~ Syarat sebuah paragraf

Di setiap paragraf harus memuat dua bagian penting, yaitu:

1. Kalimat pokok

Biasanya diletakkan pada awal paragraf, tatapi 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 peryataan yang nantinya akan dijelaskan lebih lanjut oleh kalimat lainnya dalam bentuk kalimat penjelas.

      2. Kalimat Penjelas

Kalimat penjelas adalah kalimat yang memberikan penjelasan tambahan atau detil rincian dari kalimat pokok suatu paragraf.

~ Bagian-bagian suatu paragraf yang baik

a.      Terdapat ide atau gagasan yang menarik dan diperlukan untuk merangkai kesulurahan tulisan

b.      Kalimat yang satu dengan yang lain saling berkaitan dan berhubungan dengan wajar.

Sumber : link

Lampiran

Berisi tentang informasi yang berhubungan dengan buku

Contoh lampiran: link

Judul

• Judul adalah nama yang dipakai untuk buku, bab dalam buku, kepala berita, dan lain-lain; identitas atau cermin dari jiwa seluruh karya tulis, bersifat menjelaskan diri dan yang manarik perhatian dan adakalanya menentukan wilayah (lokasi). Dalam artikel judul sering disebut juga kepala tulisan.  

• Judul adalah lukisan singkat suatu artikel atau disebut juga miniatur isi bahasan. Judul hendaknya dibuat dengan ringkas, padat dan menarik. Judul artikel diusahakan tidak lebih dari lima kata, tetapi cukup menggambarkan isi bahasan.

~Syarat-syarat pembuatan judul:

·         1. Harus relevan, yaitu harus mempunyai pertalian dengan temanya, atau ada pertalian dengan beberapa bagian penting dari tema tersebut.

·         2. Harus provokatif, yaitu harus menarik dengan sedemikian rupa sehingga menimbulkan keinginan tahu dari tiap pembaca terhadap isi buku atau karangan. 

·         3. Harus singkat, yaitu tidak boleh mengambil bentuk kalimat atau frasa yang panjang, tetapi harus berbentuk kata atau rangklaian kata yang singkat. Usahakan judul tidak lebih dari lima kata. 

Sumber : link

Resume Kuliah Teknik Dokumentasi Aplikasi - Pertemuan 3

TIPE-TIPE BUKU

Kualitas teknik Dokumentasi

 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.
• Informasi yang digunakan akurat
• Customer tidak banyak tanya
• Pengeluaran yang dikeluarkan dengan rendah :
• Memberikan batasan yang rendah terhadap orang yang tidak suka membaca
• Mengurangi biaya dukungan dari customer support
• Tidak banyak turun lapangan tetapi banyak memmbaca buku petunjuk
• Meningkatkan penjualan

6 langkah dalam proses menulis :

• Analisa pembaca : Mengetahui dan menganalisa siapa yang akan membaca buku kita sangatlah penting, hal ini dikarenakan agar buku yang telah dibuat tidak salah sasaran.
• Membuat ringkasan : Agar para pembaca mengetahui definisi awal atau ringkasan dari buku maka perlu ditambahkan untuk menarik minat para pembaca.
• Mebuat rincian : Setelah ringkasan dapat membuat tertarik para pembaca, tentu saja di dalam buku harus dibuatkan pendefinisian secara rinci mengenai materi yang dibawakan.
• Memilih gaya dan format yang akan digunakan : Gaya penulisan dan format penulisan perlu diperhatikan agar tidak membuat pembaca merasa bosan dengan isi buku dan juga agar pembaca tertarik untuk membaca buku.
• Menulis buku manual : Setelah semua bahan di atas dipersiapkan, maka sekarang waktunya untuk menulis bukunya berdasarkan konsep - konsep di atas.
• Mencoba buku manual : Jika buku sudah dibuat, proses selanjutnya melakukan percobaan kepada para pembaca.

4 macam buku manual aplikasi / software :

• Pengantar panduan : Berguna sebagai gambaran awal atau pengantar dari software / aplikasi yang dimaksud, mendeskripsikan fitur - fitur dari produk, dan menjelaskan keuntungan bila memakai produk tersebut. 

         - Contoh Introduction manual : Link Pengantar Panduan

• Panduan pelatihan : Untuk membantu pengguna apa yang harus mereka lakukan, menjelaskan bahwa apa yang mereka lakukan itu sudah benar, dan memberikan pengguna rasa percaya diri dalam menjalankan produk tersebut. 

          - Contoh training manual : Link training manual

• Panduan user : Untuk mengenalakan seluruh kemampuan dari sistem yang dibuat, mengetahui bagaimana caranya menggunakan produk ini seperti apa yang mereka inginkan, dan menunjukkan bagaimana mencapai hasil dengan menggunakan produk ini. 

          - Contoh user manual : Link user manual

• Panduan referensi : Memberikan pengetahuan lebih dari produk yang dibuat dan tambahan informasi jika pengguna ingin belajar lebih jauh dari produk ini dan hal apapun yang berhubungan dengan produk ini. 

         - Contoh reference manual : Link referensi manual