Documentation works like a joke: if you have to explain it, it’s a failure.

Dokumentasi seharusnya mencerahkan, bukan malah menjadikan pembacanya sakit kepala.

Ada satu ungkapan yang cukup sering terdengar di dunia teknologi dan project management: “Dokumentasi itu seperti sebuah bercandaan; kalau harus dijelaskan, berarti itu gagal”. Kalimat ini terdengar sinis, tapi justru sangat relevan. Karena pada kenyataannya, dokumentasi yang baik tidak menuntut penjelasan tambahan. Orang membacanya, lalu mengerti. Titik.

Begitu sebuah dokumen memicu pertanyaan mendasar; “ini maksudnya apa?”, “ini dipakai kapan?”, atau “kenapa harus begini?”; itu tanda bahwa dokumentasi tersebut belum menjalankan perannya. Ia ada, tapi tidak membantu. 😒

Di banyak perusahaan, dokumentasi sering dianggap pelengkap. Dibuat setelah sistem berjalan, sekadar memenuhi kewajiban. Strukturnya rapi, bahasanya formal, tapi isinya terlalu umum. Tidak salah secara tata bahasa, tapi lemah secara fungsi. Akhirnya dokumen itu disimpan, jarang dibuka, hanya jadi pajangan, sebagai tanda bahwa “pernah punya”, dan perlahan dilupakan.

Padahal esensi dokumentasi sangat sederhana: memastikan semua orang memahami hal yang sama. Mengurangi ruang tafsir. Menutup celah asumsi. Dokumentasi seharusnya menjadi sumber kebenaran bersama, bukan sumber kebingungan baru.

Setidaknya, dokumentasi yang sehat selalu menjawab tiga pertanyaan inti:

1. Apa yang perlu dilakukan?

2. Bagaimana cara melakukannya?

3. Dan apa konsekuensinya jika langkah tersebut tidak dilakukan dengan benar?

Jika salah satu tidak jelas, pembaca akan menebak sendiri. Dan tebak-tebak buah manggis di lingkungan kerja adalah potensi masalah.

Ini terasa banget dalam implementasi ERP, khususnya di perusahaan logistik.

5 tahun sudah saya terjun di dunia implementas system dan menjadi seornang bisnis analis, saya masih percaya bahwa ERP di perusahaan logistik bukanlah sistem yang sederhana. Ia menyentuh banyak proses sekaligus: penerimaan barang, pengiriman, pengelolaan stok, penagihan, hingga integrasi dengan vendor eksternal. Penggunanya pun beragam; mulai dari tim gudang, operasional, finance, sampai IT. Masing-masing punya cara pandang dan kebutuhan yang berbeda. Dokumentasi menjadi penghubung utama di antara mereka.

Sayangnya, dokumentasi ERP sering ditulis dari perspektif teknis. Fokus pada menu, field, dan alur sistem, tapi minim konteks operasional. Banyak instruksi terdengar normatif: “isi data sesuai prosedur” atau “lakukan proses standar”. Masalahnya, prosedur yang mana? Dalam kondisi apa? Kalau datanya belum lengkap, apa langkah yang benar?

Ketidakjelasan ini membuat satu sistem dipraktikkan dengan cara berbeda di tiap lokasi. Cabang A melakukan input sebelum barang datang, cabang B setelahnya. Dampaknya merembet ke stok yang tidak akurat, laporan yang tidak konsisten, dan akhirnya muncul kesimpulan klasik: “Sistemnya nya ribet.”

Padahal sering kali yang rumit bukan sistemnya, melainkan dokumentasi yang gagal menjelaskan konteks.

Dokumentasi ERP yang efektif seharusnya tidak hanya menjelaskan cara klik, tapi juga alasan di baliknya. Kapan sebuah transaksi harus dibuat. Siapa yang bertanggung jawab. Apa dampaknya ke inventory, SLA, dan penagihan. Dengan begitu, pengguna tidak hanya mengikuti instruksi, tapi memahami logika prosesnya.

Bahasa juga memegang peran besar. Dokumentasi bukan dokumen akademis. Ia tidak perlu terdengar canggih. Justru semakin lugas dan langsung ke poin, semakin berguna. Kalimat aktif, contoh nyata, dan alur yang jelas jauh lebih membantu dibanding paragraf panjang yang terdengar resmi tapi sulit dicerna.

Sering ada kekhawatiran bahwa dokumentasi yang terlalu detail akan terasa berat. Padahal yang melelahkan bukan banyaknya detail, namun justru ketidakjelasannya. Orang tidak keberatan membaca dokumentasi yang berlembar-lembar, yang penting setelah itu mereka benar-benar paham apa yang harus dilakukan.

Di lingkungan kerja yang orang-orangnya selalu dituntut untuk kerja cepat, dokumentasi adalah alat penghemat waktu yang sering dipandang sepele. Dokumentasi yang “works” sangat bisa mengurangi meeting-meeting yang tidak perlu, mengurangi kesalahan-kesalahan berulang, dan menghilangkan ketergantungan pada satu orang “yang dianggap paling tahu”. Selebihnya, dokumentasi yang jelas akan memberi rasa percaya diri bagi siapa pun yang terlibat dalam menjalankan proses.

Ketika dokumentasi tidak lagi menjadi “beban” atau “pajangan”, ia berubah menjadi “buku saku” yang sangat berguna.

Jadi benar ya, dokumentasi memang seperti lelucon. Jika harus dijelaskan berulang kali, berarti pesannya tidak sampai. Dokumentasi yang baik tidak berusaha terlihat pintar. Ia mudah dipahami. Dan di situlah nilai sebenarnya. 😃