0Pricing
Git & GitHub Professional Workflow · Pelajaran

Membuat Changelog dan Catatan Rilis

Pelajari cara menghasilkan changelog dan catatan rilis otomatis yang jelas dari riwayat Git dan commit konvensional Anda.

Membuat Changelog dan Catatan Rilis adalah pelajaran Git & GitHub Professional Workflow gratis di CoddyKit. Ini adalah pelajaran 4 dari 4. Kamu bisa membaca pelajaran lengkapnya di bawah secara gratis — lalu praktikkan langsung di browser dengan editor kode bawaan dan tutor AI 24/7. Ini adalah bagian dari jalur belajar Git & GitHub Professional Workflow, dan progresmu tersinkronisasi di web dan aplikasi CoddyKit. Kursus Git & GitHub Professional Workflow mencakup 4 pelajaran total.

Apa Itu Catatan Perubahan?

Catatan perubahan adalah daftar perubahan penting untuk setiap versi yang disusun dan mudah dibaca manusia. Catatan ini berada dalam berkas seperti CHANGELOG.md di akar repositori.

Mengapa Catatan Perubahan Penting

Pengguna dan anggota tim membaca catatan perubahan untuk memahami:

  • Fitur baru
  • Perbaikan bug
  • Perubahan yang dapat menyebabkan kerusakan

Catatan ini membuat peningkatan versi lebih aman dan cepat.

Format Keep a Changelog

Konvensi umum mengelompokkan entri di bawah judul: Ditambahkan, Diubah, Diperbaiki, Dihapus.

## [1.2.0] - 2024-05-01
### Added
- Search filters
### Fixed
- Login redirect bug

Komit Konvensional

Komit konvensional menggunakan awalan seperti feat:, fix:, dan BREAKING CHANGE: agar alat dapat membuat catatan perubahan secara otomatis.

feat: add CSV export
fix: handle empty cart
feat!: drop Node 14 support

Mencantumkan Komit Sejak Tag

Anda dapat melihat pratinjau perubahan sejak rilis terakhir menggunakan git log dengan rentang tag.

git log v1.1.0..HEAD --oneline

Log Rapi untuk Catatan

Format log menjadi baris berpoin yang cocok untuk ditempel ke catatan rilis.

git log v1.1.0..HEAD --pretty=format:'- %s'

Alat Catatan Perubahan Otomatis

Alat seperti standard-version atau conventional-changelog membaca komit konvensional dan membuat catatan perubahan sekaligus meningkatkan versi.

npx standard-version

Catatan yang Dibuat Otomatis GitHub

GitHub dapat membuat catatan rilis secara otomatis dari pull request yang telah digabungkan saat Anda membuat rilis.

gh release create v1.2.0 --generate-notes

Mengategorikan dengan Label

Berkas .github/release.yml memetakan label PR ke bagian catatan perubahan, sehingga perbaikan bug dan fitur dikelompokkan secara otomatis.

changelog:
  categories:
    - title: Features
      labels: [feature]

Meninjau Sebelum Menerbitkan

Selalu baca catatan yang dibuat sebelum menerbitkannya. Otomatisasi membuat drafnya, tetapi manusia harus memperbaiki susunan kata dan menonjolkan perubahan yang dapat menyebabkan kerusakan.

Menautkan ke Rilis

Pastikan setiap entri catatan perubahan tertaut ke tag Git dan halaman rilisnya agar pembaca dapat langsung melihat perbedaan yang tepat.

[1.2.0]: https://github.com/you/repo/compare/v1.1.0...v1.2.0

Pemeriksaan Singkat

Uji pemahaman Anda tentang catatan perubahan dan catatan rilis.

Ringkasan

Anda telah mempelajari cara membuat catatan perubahan:

  • Gunakan format Keep a Changelog
  • Komit konvensional menjadi dasar otomatisasi
  • git log v1..HEAD menampilkan pratinjau perubahan
  • gh release create --generate-notes membuat draf catatan dari PR

Pertanyaan yang Sering Diajukan

Apakah pelajaran “Membuat Changelog dan Catatan Rilis” gratis?

Ya — teks lengkap “Membuat Changelog dan Catatan Rilis” gratis dibaca di sini di web. Untuk praktiknya secara interaktif (editor kode bawaan dan tutor AI 24/7) dan buka sisa kursus Git & GitHub Professional Workflow, upgrade ke CoddyKit PRO. Kursus Git & GitHub Professional Workflow mencakup 4 pelajaran total.

Apa yang akan aku pelajari di “Membuat Changelog dan Catatan Rilis”?

Pelajari cara menghasilkan changelog dan catatan rilis otomatis yang jelas dari riwayat Git dan commit konvensional Anda. Kamu berlatih Git & GitHub Professional Workflow dengan kode praktik yang langsung kamu jalankan di browser, dan tutor AI 24/7 menjawab pertanyaanmu saat kamu mengerjakan pelajaran ini.

Apakah aku perlu pengalaman untuk memulai Git & GitHub Professional Workflow?

Tidak diperlukan pengalaman sebelumnya. Git & GitHub Professional Workflow di CoddyKit dirancang untuk pemula hingga pelajar tingkat lanjut, jadi kamu bisa memulai di sini atau dari awal dan belajar sesuai kecepatan kamu sendiri. Ini adalah pelajaran 4 dari 4.

Berapa lama pelajaran “Membuat Changelog dan Catatan Rilis” memakan waktu?

Sebagian besar pelajaran CoddyKit memakan waktu sekitar 5–10 menit. Setiap pelajaran ringkas dan interaktif, jadi kamu membuat kemajuan stabil dan melanjutkan dari tempat kamu tinggalkan di web dan aplikasi.

Bisakah aku menulis dan menjalankan kode dalam pelajaran Git & GitHub Professional Workflow ini?

Ya. Setiap pelajaran Git & GitHub Professional Workflow menyertakan editor kode bawaan, jadi kamu menulis dan menjalankan kode nyata langsung di browser dan mendapatkan umpan balik AI instan — tidak diperlukan penyiapan lokal.

Semua pelajaran dalam kursus ini

  1. Penerapan Versi Semantik dengan Tag
  2. Membuat dan Mengelola Rilis
  3. Branch Rilis & Hotfix
  4. Membuat Changelog dan Catatan Rilis
← Kembali ke Git & GitHub Professional Workflow