Değişiklik günlüğü
Değişiklik günlüğü
“Değişiklik günlüğü” başlıklı bölümNextPDF ekosistemi birden çok paketi ve depoyu kapsar. Bu sayfa, ekosistemde değişikliklerin nasıl kaydedildiğini ve her paketin kendi değişiklik günlüğünü nerede tuttuğunu gösterir. Bu sayfayı, her commit’in tekrarı olarak değil, bir dizin ve kurallar başvurusu olarak kullanın. Her paket, esas alınacak yayımlanmış değişiklik günlüğünü kendi deposunda tutar. Özet tablosu yalnızca, her deponun Conventional Commits geçmişinden türetilen yayımlanmış sürüm başına değişiklik kategorilerini bir araya getirir.
Bu sayfa bir belge dizinidir; hiçbir paket hakkında davranışsal iddia taşımaz. Her paketin commit oluştururken ve sürüm yayımlarken izlediği kuralları görmek için Değişiklik günlüğü kuralları sayfasına bakın.
Değişiklik nasıl kaydedilir
“Değişiklik nasıl kaydedilir” başlıklı bölümHerkese açık her NextPDF deposu iki sözleşmeyi izler:
- Conventional Commits 1.0.0 — her commit konusu
type(scope): descriptionbiçimini kullanır; buradatypeşunlardan biridir:feat,fix,perf,refactor,docs,test,build,ci,choreveyarevert. type/scope sonrasında bir!işareti ya da birBREAKING CHANGE:alt bilgisi, geriye dönük uyumsuz bir değişikliği işaretler. Güvenlikle ilgili düzeltmeler, bunları filtreleyebilmeniz için etiketlenir. - Semantic Versioning 2.0.0 — bir
feat, minör sürümü; birfix/perf, yama sürümünü; kırıcı bir değişiklik ise majör sürümü yükseltir. Her depodaki yayımlanmışCHANGELOG.md, Keep a Changelog bölümlerini kullanarak insan tarafından okunabilir girdileri sürüme göre gruplar.
Aşağıdaki özet yalnızca kullanıcıya yönelik kategorileri kapsar: feat (yeni yetenek), fix (düzeltilmiş davranış), perf (başarım), security (güvenlikle ilgili düzeltme) ve kırıcı değişiklikler. Yalnızca dahili nitelikteki commit türleri (docs, test, ci, chore, refactor) bilinçli olarak depolar arası özetin dışında tutulmuştur. Paketi kullanırken gözlemlediğiniz davranışı değiştirmezler.
Her paketin değişiklik günlüğü nerede bulunur
“Her paketin değişiklik günlüğü nerede bulunur” başlıklı bölümBir paketin esas alınacak metin tabanlı değişiklik günlüğü, o paketin kendi deposundaki, yayımlanmış sürümlere göre gruplanmış CHANGELOG.md dosyasıdır. Girdilerin tam metni için deponun sürüm sayfasını veya CHANGELOG.md dosyasını kullanın. Bu dizin o metni tekrarlamaz.
| Paket | Depo | Yetkili değişiklik günlüğü |
|---|---|---|
nextpdf/core | nextpdf | CHANGELOG.md (Keep a Changelog) |
nextpdf/server | nextpdf-server | CHANGELOG.md |
nextpdf/laravel | nextpdf-Laravel | CHANGELOG.md |
nextpdf/symfony | nextpdf-Symfony | CHANGELOG.md |
nextpdf/codeigniter | nextpdf-CodeIgniter | CHANGELOG.md |
nextpdf/artisan | nextpdf-Artisan | CHANGELOG.md |
nextpdf/gotenberg | nextpdf-Gotenberg | CHANGELOG.md |
nextpdf/cloudflare | nextpdf-Cloudflare | CHANGELOG.md |
nextpdf/compat-legacy | nextpdf-compat-tcpdf | CHANGELOG.md |
nextpdf (Python bağlamaları) | nextpdf-python | CHANGELOG.md |
Depolar arası özet — en son yayımlanan sürüm başına kategoriler
“Depolar arası özet — en son yayımlanan sürüm başına kategoriler” başlıklı bölümBu salt okunur tablo, her deponun en son yayımlanmış etiketine kadar olan Conventional Commits geçmişinden oluşturulur. Kullanıcıya yönelik kategorilerin sayısını çıkarır ve yalnızca kategori sayılarını raporlar; ham commit konularını asla raporlamaz. Bu nedenle dahili tanımlayıcıları, dal adlarını veya planlama referanslarını açığa çıkarmaz. Herhangi bir satırın arkasındaki metinsel ayrıntılar için paketin kendi CHANGELOG.md dosyasını izleyin.
| Paket | En son yayımlanan | Yeni yetenek (feat) | Düzeltmeler (fix) | Başarım (perf) | Güvenlik | Kırıcı |
|---|---|---|---|---|---|---|
nextpdf/core | v5.2.0 | 317 | 290 | 1 | 1 | yes |
nextpdf/server | v0.1.0 | 15 | 16 | 0 | 0 | no |
nextpdf/laravel | v0.1.0 | 1 | 8 | 0 | 0 | no |
nextpdf/symfony | v0.1.0 | 1 | 7 | 0 | 0 | no |
nextpdf/codeigniter | v0.1.0 | 1 | 10 | 0 | 0 | no |
nextpdf/artisan | v0.1.0 | 1 | 7 | 0 | 0 | no |
nextpdf/gotenberg | v0.1.0 | 0 | 6 | 0 | 0 | no |
nextpdf/cloudflare | v0.1.0 | 0 | 8 | 0 | 0 | no |
nextpdf/compat-legacy | v0.1.0 | 1 | 8 | 0 | 0 | no |
nextpdf (Python) | v1.1.0 | 7 | 5 | 0 | 0 | no |
Sayılar, belirtilen etikete kadar kümülatiftir. Her tümleştirme paketi için, etiketlenen ilk sürüm, paketin 1.0 öncesi tüm geçmişini içerir.
nextpdf/coreiçin “Breaking” hücresiyesdeğerini gösterir; çünkü çekirdek motor kırıcı majör sürümler yayımlamıştır. Her biri için sürüm bazındaki ayrıntılar ve geçiş yolu, çekirdek deposununCHANGELOG.mddosyasında vemigration/kılavuzlarında bulunur. Bu dizin bunları yeniden belirtmez.
Bu sayfanın bilerek dışarıda bıraktığı içerik
“Bu sayfanın bilerek dışarıda bıraktığı içerik” başlıklı bölümKamuya açık değişiklik günlüğünde dahili bilgilerin sızmasını önlemek için bu dizin aşağıdakilerin hiçbirini asla açığa çıkarmaz:
- ham commit konuları veya gövdeleri;
- dahili sorun, talep, döngü, dalga veya iş öğesi tanımlayıcıları;
- özel dal adları veya yayımlanmamış devam eden çalışmalar;
- yol haritası veya duyurulmamış özellikler;
- katkı sağlayan otomasyon atıfları.
Bir değişiklik burada ancak herkese açık bir paketin yayımlanmış, etiketlenmiş bir sürümünün parçası olduktan sonra görünür. Yayımlanmamış çalışmalar görünmez.