Generator Changelog

Menulis changelog secara manual berarti menyisir git log setiap kali rilis. Generator ini melewati langkah tersebut: Anda menempelkan entri yang ingin dipublikasikan langsung ke kategori yang tepat, Added, Changed, Fixed, dan Removed, menambahkan nomor versi dan tanggal, lalu alat ini menyusun bagian Markdown bergaya Keep a Changelog yang siap disisipkan ke CHANGELOG.md. Konten yang sama juga dapat dibuat sebagai teks biasa. Alat ini tidak membaca riwayat git Anda; Andalah yang menentukan perubahan mana yang masuk ke rilis.

Cara membuat changelog

  1. 1

    Masukkan versi dan tanggal

    Ketik nomor versi, misalnya 1.2.0. Biarkan tanggal kosong untuk menggunakan tanggal hari ini.

  2. 2

    Tambahkan entri per kategori

    Tempel catatan rilis ke Added, Changed, Fixed, dan Removed, satu entri per baris. Kategori kosong dilewati.

  3. 3

    Pilih format keluaran

    Markdown (judul `## [versi] - tanggal` dengan bagian bergaya `### Added`) atau teks biasa (judul `v1.2.0 (tanggal)` dengan daftar berpoin).

  4. 4

    Salin changelog

    Tempel keluaran di atas entri sebelumnya di CHANGELOG.md.

Empat kategori

Generator menghasilkan tepat empat bagian, dengan urutan ini: Added, Changed, Fixed, dan Removed. Judul bagian pada keluaran tetap dalam bahasa Inggris, sesuai istilah standar Keep a Changelog.

Kategori Kapan digunakan
Added Fitur baru
Changed Perubahan pada fungsionalitas yang ada
Fixed Perbaikan bug
Removed Fitur yang telah dihapus

Konvensi Keep a Changelog juga mengenal bagian Deprecated, Security, dan Breaking. Generator tidak memiliki kolom untuk bagian tersebut; Anda dapat menambahkan bagian itu secara manual setelah menempel hasilnya.

Contoh keluaran (Markdown)

## [1.4.0] - 2026-04-18

### Added
- Dark mode support for the dashboard (#312)
- CSV export on the users page (#318)

### Changed
- Upgrade React to 18.3 (#320)
- Pagination now defaults to 50 items per page (#322)

### Fixed
- Crash when editing users with a null email (#319)
- Timezone offset in scheduled reports (#321)

### Removed
- Legacy reports API (#324)

Contoh keluaran (teks biasa)

v1.4.0 (2026-04-18)
ADDED:
  • Dark mode support for the dashboard (#312)
  • CSV export on the users page (#318)
CHANGED:
  • Upgrade React to 18.3 (#320)
  • Pagination now defaults to 50 items per page (#322)
FIXED:
  • Crash when editing users with a null email (#319)
  • Timezone offset in scheduled reports (#321)
REMOVED:
  • Legacy reports API (#324)

Tips

  • Satu entri per baris. Setiap baris dalam kolom menjadi satu poin. Kolom kosong dilewati, dan Anda boleh membiarkan satu kategori tanpa isi.
  • Tulis entri sebagai baris changelog, bukan catatan log. Bentuk imperatif “fix: handle null email on edit” terbaca baik sebagai poin.
  • Cantumkan nomor issue/PR agar pembaca bisa menelusuri lebih jauh: (#319) atau [#319](link) pada keluaran.
  • Satu versi per entri: jangan menggabungkan dua rilis dalam satu blok, meskipun hanya berjarak satu hari.
  • Dirilis vs belum dirilis: simpan bagian [Belum dirilis] di bagian atas untuk perubahan yang ditujukan ke versi berikutnya. Pindahkan ke bagian ber tanggal saat rilis.

Pertanyaan yang Sering Diajukan

Konvensi Keep a Changelog (keepachangelog.com): judul versi dengan tanggal dan daftar berpoin yang dikelompokkan. Generator menghasilkan bagian Added, Changed, Fixed, dan Removed; bagian standar lainnya (Deprecated, Security, Breaking) mengikuti konvensi yang sama jika Anda menambahkannya secara manual.

Generator menghasilkan empat bagian utama: Added, Changed, Fixed, dan Removed. Tidak ada kolom khusus untuk Deprecated, Security, atau Breaking, tetapi Anda dapat menambahkan bagian tersebut secara manual ke teks yang dihasilkan sebelum menempelnya.

Generator adalah alat antarmuka sekali pakai; untuk otomatisasi gunakan CLI seperti standard-version, release-please, atau semantic-release yang menerapkan pola yang sama di jalur build Anda.

Tidak. Alat ini tidak membaca repositori atau pesan commit Anda; Anda menempelkan entri sendiri. Teks yang Anda ketik dikirim ke server untuk menyusun keluaran dan tidak disimpan atau dibagikan.

Alat Terkait