Jumat, 03 Januari 2014

User Documentation and Online Help

Paper vs. Online Manual
Bentuk user manual dalam kertas :
  1. Install manual
  2. Brief getting-started notes 
  3. Introductory tutorial 
  4. Thorough tutorial 
  5. Detailed reference manual 
  6. Quick reference card 
  7. Conversation manual

Online material :
  1. Online manual 
  2. Online help 
  3. Context-sensitive help
  4. Online tutorial
  5. Animated demonstration
  6. Guides
  7. FAQs
  8. Online community, newsgroups, listserver, e-mail, chat, instant messaging
Tujuan
Paper
Online
Buy
-     Brosur penjualan
-     Fact sheet
Demonstrasi dengan animasi
Learn
Tutorial
-     Menual
-     Tutorial
-     Guide
-     Demonstrasi dengan animasi
User
User Manual
-     Manual
-     Help
-     Context-sensitive help
Slove problem
FAQ
-     Help
-     FAQ
-     Online community


Keuntungan mengunakan online manual :
  1. Keuntungan fisik
  2. Keuntungan navigasi
  3. Keuntungan ekonomis
  4. Layanan interaktif
Kerugian mengunakan online manual :
  1. Kurang readable dibanding kertas
  2. Informasi kurang dibanding kertas
  3. Interface mungkin baru dan membingungkan pemula
  4. Usaha ekstra diperlukan untuk menavigasi antar screen, dapat  mengganggu konsentrasi dan pembelajaran, serta penjelasan mungkin sulit
  5. Display help/tutorial mengurangi ruang untuk menampilkan work
  6. Perangkat kecil seperti HP kekurangan ruang untuk online help

Reading from Paper vs. from Display
Waktu pengerjaan tugas dengan membaca dari display komputer lebih lama dibanding dengan menggunakan kertas
Kerugian menggunakan display :
  1. Font buruk, terutama pada layar resolusi rendah 
  2. Kontras antara karakter dan background  rendah
  3. Batas karakter tidak jelas
  4. Emisi cahaya display lebih sulit untuk dibaca dibandingkan cahaya pantulan kertas 
  5. Glare pada layar lebih besar
  6. Layar dapat berkedip (flicker) 
  7. Permukaan layar mungkin melengkung 
  8. Display kecil memerlukan pembalikan halaman yang banyak 
  9. Jarak membaca yang diperlukan lebih besar dari kertas 
  10. Display memiliki posisi yang fix
  11. Penempatan display mungkin terlalu tinggi
  12. Layout dan format
  13. Kurangnya gerakan tangan dan tubuh 
  14. Postur kaku
  15. Kurangnya pengenalan display dan kecemasan bahwa gambar dapat hilang meningkatkan stress

Membentuk Isi dari Manual
Materi pelatihan dan referensi biasa dibuat oleh development team junior.
Keuntungan dari menual yang didesain dengan baik adalah waktu pembelajaran yang lebih kecil, user perfomance yang lebih baik, kepuasan user yang tinggi, dan telepon untuk support lebih sedikit
“Active user paradox” : 
keinginan user untuk melakukan kegiatan yang berarti seringkali mencegah mereka untuk menghabiskan dengan hanya belajar saja, sehingga keterampilan mereka hany standar (mediocre)

User Manual Guideline

Berdasarkan latihan dan empirical study (Carroll et al) :
  1. Pilih pendekatan action-oriented
  2. Biarkan tugas user memandu organisasi
  3. Dukungan error recognition dan recovery 
  4. Dukungan reading-to-do, studi, dan melokasikan

The User manual for adobe reader :
Organization and writing style
  1. Pernyataan yang precise dari tujuan pendidikan
  2. Konsep terurut secara logis, sesuai dengan tingkat kesulitan
  3. Memastikan bahwa setiap konsep digunakan dalam bagian berikutnya
  4. Menghindari referensi forward
  5. Membangun bagian dengan jumlah sama (kurang-lebih) dengan jumlah materi baru
  6. Ada contoh yang cukup dan sesi sampel lengkap
  7. Memilih kata dan frase yang tepat
  8. Panduan style organisasi untuk memastikan konsistensi dan kualitas tinggi
  9. Gaya penulisan sesuai dengan kemampuan membaca user
Online manual and help
Guideline untuk sistem online help (Kearsley) :
  1. Membuat sistem help mudah diakses dan di-return
  2. Membuat help se-spesifik mungkin
  3. Mengumpulkan data untuk menentukan help apa yang diperlukan
  4. Memberikan kontrol sistem sebanyak mungkin kepada user 
  5. Membuat pesan help yang akurat dan lengkap
  6. Tidak menggunakan bantuan untuk mengimbangi desain interface yang buruk
Online manual

Sama dengan manual yang di-print, namun ditingkatkan dengan fitur online spesial 
Efektif jika didesain ulang sehingga sesuai dengan medium elektronik, untuk mengambil keuntungan dari :
  1. Multiple window
  2. Text highlighting
  3. Color 
  4. Sound 
  5. Animation 
String search dengan feedback yang relevan
Daftar isi yang dirancang dengan baik tetap terlihat sisi halaman
Pemula memerlukan tutorial
Intermittent knowledgeable user dapat menangani deskripsi interface syntax dan semantic yang sedikit
Daftar keyword ditingkatkan dengan pengelompokan kategori
Online help

Biasa hanya ada sedikit informasi tentang cara meyusun action untuk melakukan tugas
User berahrap bahwa dapat melakukan search atas full text dari dokumen online
Memperluas dan menyusun daftar isi dapat dikombinasikan dengan search
Answer wizard dapat merespon request yang menggunakan natural language 

 
Online tutorial, demonstration, and animation
Online tutorial
  1. Tidak harus mengubah perhatian antara terminal dan material instruksi
  2. Diperlukan latihan skill untuk menggunakan sistem
  3. Dapat bekerja sendiri tanpa rasa malu kepada instruktor atau teman akan kesalahan 
  4. Tips start-up
Demonstration system

Didistribusikan dengan CD-ROM/DVD atau melalui internet
Dirancang untuk menarik user potensial
Biasa menampilkan fitur dengan animasi, grafis warna, suara, dll
User-interface requirement :
  1. Menangkap dan mempertahankan user interest 
  2. Menyampaikan informasi
  3. Membangun image positif produk
Kontrol :
  1. Pacing automatic atau manual 
  2. Panjang demonstration (short vs.in-depth) 
  3. Stop, replay, skip 
 
Development process guidelines
  1. Mencari writer dan copywriter profesional
  2. Mempersiapkan user untuk documentation terlebih dulu (sebelum implementasi)
  3. Mengatur dokumen guideline, mengkoordinasikan dan mengintegrasikan seluruh departemen yang terlibat
  4. Merevie seluruh draft
  5. Edisi awal field-test 
  6. Menyediakan mekanisme feedback untuk reader
  7. Merevisi untuk mencerminkan perubahan secara teratur

Tidak ada komentar:

Posting Komentar