Engineering
Changelog sebagai artefak build: konvensi, otomatisasi, pipeline.
Mulai dari sini: Keep a Changelog dijelaskan, dengan template CHANGELOG.md, Dari conventional commits ke changelog, Otomatisasi changelog: apa yang diotomatisasi dan tidak
-
Apa itu hotfix? Arti, hotfix vs patch, cara merilisnya
Hotfix adalah perbaikan mendesak yang dirilis di luar siklus rilis biasa. Arti istilahnya, bedanya dengan patch atau bugfix, dan cara merilis dengan aman.
Engineering6 menit baca
-
Release candidate (RC): arti dan cara menjalankannya
Release candidate adalah build yang dirilis sebagai versi final kecuali tes menemukan blocker. Letak RC setelah beta, cara memberi versi, dan syarat lulus.
Engineering4 menit baca
-
CHANGELOG.md: apa isinya dan cara menjaganya tetap mutakhir
CHANGELOG.md adalah catatan untuk pembaca tentang apa yang berubah di tiap versi. Bagian yang perlu ada, contoh lengkap, dan kebiasaan yang menjaganya.
Engineering5 menit baca
-
Release notes GitHub: buat otomatis, lalu rapikan isinya
GitHub bisa membuat draf release notes dari pull request yang di-merge dalam sekali klik. Isinya, peran release.yml, dan tahap edit agar enak dibaca.
Engineering6 menit baca
-
Proses manajemen rilis untuk tim yang sering merilis
Proses manajemen rilis untuk tim software dalam tujuh langkah, dengan pemilik dan kriteria selesai tiap langkah, plus metrik DORA dan satu KPI tambahan.
Engineering6 menit baca
-
Siapa yang menulis changelog, dan siapa yang seharusnya
Siapa yang menulis changelog? Penulis PR tahu apa yang berubah, PM tahu kenapa itu penting. Sendirian, keduanya tidak menulis entri yang berguna.
Engineering5 menit baca
-
Format berkas changelog: JSON, YAML, atau cukup Markdown
Format berkas changelog menentukan apakah ia bisa memasok halaman dan widget, atau hanya dibaca manusia. Markdown, JSON, dan YAML punya biaya yang berbeda.
Engineering5 menit baca
-
Wajibkan entri changelog di GitHub Actions: workflow
Check changelog di GitHub Actions menolak merge tanpa entri, karena langkah yang bergantung pada ingatan akan gagal. Plus apa yang dirusak oleh check itu.
Engineering5 menit baca
-
Tag git vs rilis GitHub vs changelog
Tag git, rilis, dan entri changelog adalah tiga catatan dari satu peristiwa. Mencampuradukkannya membuat changelog melenceng. Cara ketiganya selaras.
Engineering5 menit baca
-
Changelog monorepo: satu saja, atau satu per paket?
Monorepo bisa punya satu changelog untuk seluruh repo atau satu per paket. Salah pilih membuat rilis terlalu berisik dibaca atau terlalu tersebar dicari.
Engineering5 menit baca
-
Semantic versioning dan changelog: arti tiap kenaikan
Semantic versioning memberi tahu seberapa sakit sebuah rilis sebelum changelog dibaca. Apa yang dijanjikan tiap angka, dan tanggung jawab sebuah entri.
Engineering5 menit baca
-
Halaman changelog publik: cara membangun yang diikuti
Halaman changelog layak dibangun ketika orang kembali lagi. Di mana letaknya, apa yang dibutuhkan tiap entri, feed dan markup, serta posisi widget.
Engineering6 menit baca
-
Otomatisasi changelog: apa yang diotomatisasi dan tidak
Otomatisasi pengumpulan, pemformatan dan penerbitan. Jangan otomatisasi seleksi atau formulasi. Di mana batasnya dan apa yang terjadi setiap kali bergeser.
Engineering6 menit baca
-
Dari conventional commits ke changelog
Conventional commits membuat changelog bisa diturunkan, tetapi tidak mudah dibaca. Apa yang diberikan konvensi, di mana berhenti, dan cara menutup celah.
Engineering5 menit baca
-
Keep a Changelog dijelaskan, dengan template CHANGELOG.md
Spesifikasi Keep a Changelog hanya satu halaman. Saat implementasi, tim menyimpang. Apa katanya, apa yang dibiarkan terbuka, dan di mana salahnya.
Engineering5 menit baca