Cara menggunakan Generator Changelog
- Jalankan perintah
git logyang ditampilkan di atas di repository kamu, lalu tempel outputnya (hash + subject per baris). - Masukkan versi saat ini; versi rilis akan disarankan dari commit — atau ketik sendiri.
- Pilih heading Conventional atau Keep a Changelog, lalu tambahkan URL repository kamu untuk menautkan hash commit.
- Salin Markdown ke bagian atas
CHANGELOG.mdkamu atau ke rilis GitHub.
Conventional Commits dalam 30 detik
Setiap subject commit diawali dengan tipe, scope opsional, dan deskripsi: feat(cart): add coupon field. Tanda ! setelah tipe/scope atau catatan BREAKING CHANGE: menandai breaking change.
| Tipe | Bagian | Kenaikan versi |
|---|---|---|
feat | Features / Added | Minor |
fix | Bug Fixes / Fixed | Patch |
perf | Performance | Patch |
feat!, BREAKING CHANGE | Breaking Changes | Major |
refactor, docs, style, test, build, ci, chore | Lainnya / tersembunyi | Tidak ada |
revert | Reverts | Patch |
Keep a Changelog
Keep a Changelog mengelompokkan entri untuk dibaca manusia di bawah Added, Changed, Deprecated, Removed, Fixed, Security, rilis terbaru di atas, dengan bagian Unreleased di paling atas. Pilih gaya ini jika penggunamu membaca changelog, bukan hanya developer.
Dari changelog ke rilis
Cek versi yang disarankan dengan Semantic Version Calculator, perbarui version di package.json, lalu beri tag dan push rilisnya — Git Command Generator punya perintahnya. Workflow GitHub Actions bisa membangun dan mempublikasikan setiap tag.
Juga dicari sebagai: changelog generator, conventional commits changelog, keep a changelog, release notes generator, changelog.md, git log changelog, bikin changelog otomatis.
Tool yang cocok dipakai bersama Generator Changelog
- Pembuat Conventional Commit — Tulis pesan commit yang mengikuti spesifikasi Conventional Commits tanpa perlu menghafalnya.
- Generator README — Isi beberapa kolom dan dapatkan README.md yang rapi dan siap dipakai di GitHub, lengkap dengan badge, instalasi, contoh penggunaan, tabel konfigurasi, variabel lingkungan, roadmap, dan lisensi, plus pratinjau langsung dan cek kelengkapan.
- Validator YAML — Tempel file Docker Compose, manifest Kubernetes, workflow GitHub Actions, atau YAML apa pun untuk menemukan error, menangkap jebakan umum, dan mendapatkan versi yang sudah terformat rapi.
- Generator YAML Kubernetes — Isi nama aplikasi, image, dan port, lalu dapatkan YAML Kubernetes siap production: Deployment dengan probe, batas resource, dan security context yang diperketat, plus Service, Ingress dengan TLS, ConfigMap, Secret, dan HorizontalPodAutoscaler yang kamu centang — dalam satu file yang siap untuk kubectl apply.
Pertanyaan yang sering diajukan
Format git log apa yang sebaiknya saya tempel?
Idealnya satu commit per baris dengan short hash di awal:
git log --pretty=format:"%h %s". Subject polos tanpa hash juga bisa. Merge commit dilewati otomatis.Bagaimana versi berikutnya dihitung?
Breaking change apa pun menaikkan versi major, jika tidak ada tapi ada feat maka versi minor naik, dan jika tidak keduanya maka perbaikan dan peningkatan performa menaikkan versi patch. Untuk versi 0.x, breaking change menaikkan versi minor.
Apa yang terjadi pada commit yang tidak mengikuti Conventional Commits?
Commit tersebut dicantumkan di bawah “Other changes” (gaya Conventional) atau “Changed” (Keep a Changelog) agar tidak ada yang hilang — hapus saja baris yang tidak kamu inginkan di hasil.
Bisakah changelog dibuat otomatis di CI?
Bisa — alat seperti release-please, semantic-release, atau changesets melakukannya di setiap merge. Generator ini berguna untuk proyek kecil, rilis manual, atau untuk mengecek apa yang akan dihasilkan alat-alat tersebut.
Bisakah saya memasang Generator Changelog sebagai aplikasi web dan memakainya offline?
Bisa. Generator Changelog adalah aplikasi web (PWA) yang bisa dipasang. Pemasangannya lewat browser kamu, bukan diunduh dari toko aplikasi. Klik Pasang aplikasi di bagian atas halaman ini di Chrome atau Edge (Windows, macOS, Linux, ChromeOS) atau di Android. Di iPhone dan iPad, gunakan Bagikan → Tambahkan ke Layar Utama, dan di Safari 17+ pada Mac, gunakan File → Tambahkan ke Dock. Setelah itu, aplikasi akan terbuka di jendelanya sendiri dengan ikonnya sendiri. Karena berjalan sepenuhnya di browser kamu, aplikasi ini tetap bisa dipakai offline. Firefox di desktop tidak bisa memasang aplikasi web. Cara memasang aplikasi.