Saepul Malik
Studi kasus

Dokumentasi Design System (Storybook)

Mendokumentasikan library komponen bersama lintas aplikasi di Storybook — kini terbengkalai karena pemeliharaannya kalah prioritas dibanding shipping.

PT Inspigo Inovasi Indonesia2021–Sekarang
StorybookDesign Systems

Masalah

Design system bersama di Inspigo tidak memiliki dokumentasi tersendiri — tidak ada tempat terpusat untuk melihat komponen apa saja yang ada di seluruh aplikasi, atau cara menggunakannya.

Arsitektur

Storybook mencakup library komponen bersama yang digunakan ulang di berbagai aplikasi Inspigo, bukan semua komponen per aplikasi — hampir seluruh komponen primitif lintas aplikasi (terutama tombol dan elemen kecil sejenisnya) akhirnya memiliki story.

Eksekusi

Inisiatif sendiri, dibangun dan dirawat seorang diri. Tantangan terberatnya adalah menjaga story tetap sinkron dengan komponen aslinya seiring perkembangannya — overhead pemeliharaan tersebut pada akhirnya tidak terkejar, dan instance Storybook ini sudah tidak lagi diperbarui secara aktif.

Dampak

Membangun dan mendorong adopsi dokumentasi Storybook untuk library komponen bersama selama masa aktifnya. Tidak dapat dipresentasikan ke luar Inspigo, dan harus dipahami sebagai praktik masa lalu ketimbang sesuatu yang masih berjalan.