Changelog (Catatan Perubahan)

TL;DR: Changelog adalah catatan perubahan sebuah produk yang disusun berurutan per versi dan per tanggal. Isinya fitur baru, perbaikan, dan perubahan yang berdampak pada pengguna, ditulis dari sudut pandang pengguna, bukan dari sudut pandang commit history. Bagi produk digital, changelog yang terawat adalah bukti paling murah bahwa produk masih dikembangkan.

Apa itu Changelog?

Changelog adalah daftar kronologis perubahan produk. Setiap entri menjawab satu pertanyaan sederhana: apa yang berbeda sejak terakhir kali saya memakai produk ini. Bedanya dengan riwayat commit di repositori adalah pembacanya. Riwayat commit ditulis untuk developer dan mencatat setiap langkah teknis, sedangkan changelog ditulis untuk pengguna dan hanya memuat perubahan yang mereka rasakan.

Konvensi penulisan yang banyak dipakai adalah Keep a Changelog, yang mengelompokkan entri ke dalam kategori Added, Changed, Fixed, Deprecated, dan Removed. Penomoran versinya umumnya mengikuti Semantic Versioning dengan format MAJOR.MINOR.PATCH.

Format Entri yang Umum

Aturan praktis penulisannya: satu entri satu kalimat, memakai kata kerja aktif, dan menyebut dampak bukan implementasi. Entri seperti "refactor service layer" tidak berguna bagi pengguna karena tidak menjelaskan apa yang berubah bagi mereka.

Kenapa Penting?

Untuk produk berbasis langganan seperti SaaS, changelog mengurangi beban dukungan pelanggan. Pertanyaan berulang tentang fitur yang berubah dapat dijawab dengan satu tautan. Bagi calon pelanggan yang sedang membandingkan vendor, halaman changelog yang aktif menjawab kekhawatiran yang jarang diucapkan: apakah produk ini masih dirawat atau sudah ditinggalkan.

Changelog juga membantu tim internal. Ketika entri ditulis merujuk pada user story yang mendasarinya, tim produk punya jejak alasan sebuah perubahan dibuat, bukan sekadar catatan bahwa perubahan itu terjadi.

Pertanyaan Umum

Apakah changelog sama dengan release notes?

Beririsan tetapi tidak identik. Changelog adalah daftar ringkas seluruh perubahan yang tersusun per versi, sedangkan release notes biasanya lebih naratif, fokus pada satu rilis, dan sering ditulis dengan nada pemasaran.

Seberapa sering changelog perlu diperbarui?

Setiap kali ada perubahan yang dirasakan pengguna. Frekuensinya mengikuti ritme rilis produk, bukan jadwal kalender. Changelog yang tidak diperbarui berbulan-bulan memberi kesan produk berhenti dikembangkan, sehingga lebih baik jujur menandai periode tanpa rilis daripada membiarkan halaman menggantung.

Apakah changelog perlu dipublikasikan di website?

Untuk produk yang dijual ke publik, ya. Halaman changelog publik dapat diindeks mesin pencari dan menjadi konten yang diperbarui secara berkala tanpa perlu menulis artikel baru.