Mühendislik
Bir build çıktısı olarak changelog: kurallar, otomasyon, pipeline'lar.
Buradan başla: Keep a Changelog açıklaması: CHANGELOG.md şablonuyla, Conventional commits'ten bir changelog'a, Changelog otomasyonu: neyi otomatikleştirmeli, neyi değil
-
Hotfix nedir? Anlamı, patch farkı ve nasıl yayınlanır
Hotfix, normal release döngüsünün dışında yayınlanan acil bir düzeltmedir. Terimin anlamı, patch ve bugfix'ten farkı ve güvenle nasıl yayınlanacağı.
Mühendislik5 dk okuma
-
Release candidate (RC): ne demek ve nasıl yönetilir
Release candidate, test bir engel bulmazsa nihai sürüm olarak çıkan build'dir. Beta sonrasındaki yeri, sürüm numarası ve çıkış kuralları anlatılıyor.
Mühendislik4 dk okuma
-
CHANGELOG.md: içine ne girer ve nasıl güncel tutulur
CHANGELOG.md, her versiyonda neyin değiştiğinin okuyucuya dönük kaydıdır. Gereken bölümler, tam bir örnek ve onu güncel tutan tek alışkanlık burada.
Mühendislik4 dk okuma
-
GitHub release notes: üretin, sonra okunur hale getirin
GitHub, merge edilen pull request'lerden release notes taslağını tek tıkla çıkarır. Taslakta ne var, release.yml onu nasıl şekillendirir, nasıl düzenlenir.
Mühendislik5 dk okuma
-
Sık yayımlayan ekipler için release yönetimi süreci
Yazılım ekipleri için yedi adımda release yönetimi süreci: her adımın sahibi ve çıkış ölçütü, DORA metrikleri ve ayrıca izlemeye değer bir KPI daha.
Mühendislik6 dk okuma
-
Changelog'u kim yazar, kim yazmalı
Changelog'u kim yazar? PR yazarı neyin değiştiğini, PM neden önemli olduğunu bilir. İkisi de tek başına iyi kayıt yazamaz, varsayılan seçim onu eskitir.
Mühendislik4 dk okuma
-
Changelog dosya formatları: JSON, YAML veya sadece Markdown
Bir changelog dosyasının formatı, bir sayfayı besleyip besleyemeyeceğini belirler, yoksa sadece insan okur. Markdown, JSON ve YAML farklı bedeller öder.
Mühendislik5 dk okuma
-
GitHub Actions'ta changelog kaydı zorunlu kılın: workflow
GitHub Actions'ta bir changelog kontrolü kayıtsız merge'ü reddeder, çünkü hatırlamaya bağlı adım öngörülebilir biçimde çöker. Ve bu kontrolün bozduğu şey.
Mühendislik4 dk okuma
-
Git tag, GitHub release ve changelog: aralarındaki fark
Bir git etiketi, bir sürüm ve bir changelog girişi aynı olayın üç kaydıdır. Bunları karıştırmak changelog'un kaymasına yol açar. Üçü nasıl uyuşmalı.
Mühendislik5 dk okuma
-
Monorepo changelog'ları: tek mi, paket başına mı?
Bir monorepo tüm repo için tek changelog tutabilir veya paket başına bir tane, ve yanlış seçim her release'i ya çok gürültülü ya da çok dağınık yapar.
Mühendislik5 dk okuma
-
Semantic versioning ve changelog: her sıçrama ne demek
Semantic versioning, bir sürümün changelog'da tek kelime okumadan önce ne kadar canını yakabileceğini söyler. Her sayının vaadi, bir girişin borcu.
Mühendislik5 dk okuma
-
Herkese açık changelog sayfası: takip edilen bir sayfa
Bir changelog sayfası, biri ona geri döndüğünde değerlidir. Nerede yaşamalı, her kayıt neye ihtiyaç duyar, akışlar ve markup, ve widget nereye oturur.
Mühendislik5 dk okuma
-
Changelog otomasyonu: neyi otomatikleştirmeli, neyi değil
Toplama, biçimlendirme ve yayımlamayı otomatikleştirin. Seçimi ya da ifadeyi otomatikleştirmeyin. Çizginin nerede olduğu ve kaydığında ne olduğu.
Mühendislik5 dk okuma
-
Conventional commits'ten bir changelog'a
Conventional commits bir changelog'u türetilebilir yapar. Okunabilir yapmaz. Konvansiyonun sağladığı, durduğu yer, ve boşluğu nasıl kapatacağınız.
Mühendislik5 dk okuma
-
Keep a Changelog açıklaması: CHANGELOG.md şablonuyla
Spesifikasyon bir sayfadır ve okunması on dakika sürer. Ekiplerin saptığı yer uygulama aşamasıdır. Ne dediği, ne bıraktığı, ve nerede yanlış gittiği.
Mühendislik5 dk okuma