Materi
Diátaxis, kerangka dokumentasi yang disusun Daniele Procida, membagi dokumentasi menjadi empat jenis karena ada empat kebutuhan pembaca yang berbeda. Tutorial adalah pelajaran yang menuntun pemula lewat pengalaman praktik; tujuannya membangun keterampilan dan rasa percaya diri, bukan menyelesaikan pekerjaan. Panduan cara (how-to guide) menjawab tujuan atau masalah nyata dan ditujukan bagi pengguna yang sudah cakap dan sedang bekerja. Rujukan (reference) memuat uraian teknis yang akurat dan lengkap, netral, tanpa ajakan bertindak; susunannya mengikuti susunan benda yang diuraikan. Penjelasan (explanation) memberi latar dan konteks, menjawab pertanyaan mengapa.
Kompas Diátaxis menggolongkan dengan dua pertanyaan. Apakah isinya menuntun tindakan atau memberi pengetahuan? Apakah isinya melayani pemerolehan keterampilan (belajar) atau penerapan keterampilan (bekerja)? Jawaban keduanya menunjuk satu jenis saja.
| Isinya… | …melayani | Jenis |
|---|---|---|
| Menuntun tindakan | Belajar | Tutorial |
| Menuntun tindakan | Bekerja | Panduan cara |
| Memberi pengetahuan | Bekerja | Rujukan |
| Memberi pengetahuan | Belajar | Penjelasan |
Contoh di dokumentasi SiHadir, aplikasi presensi karangan: “Cara memindahkan jadwal sif seorang pegawai” untuk admin yang sudah terbiasa adalah panduan cara, karena menuntun tindakan untuk menyelesaikan pekerjaan.
