Changelog
Changelog
Bagian berjudul “Changelog”Ekosistem NextPDF mencakup banyak paket dan repositori. Halaman ini menjelaskan cara ekosistem mencatat perubahan dan tempat setiap paket menyimpan changelog-nya sendiri. Gunakan halaman ini sebagai indeks dan rujukan konvensi, bukan sebagai pengulangan setiap commit. Setiap paket menyimpan changelog rilis otoritatif di repositorinya masing-masing. Tabel ringkasan hanya mengagregasi kategori perubahan per versi yang dirilis, yang diturunkan dari riwayat Conventional Commits setiap repositori.
Sebagai indeks dokumentasi, halaman ini tidak memuat klaim perilaku tentang paket mana pun. Untuk melihat aturan yang diikuti setiap paket saat menulis commit dan menerbitkan rilis, lihat Konvensi changelog.
Cara perubahan dicatat
Bagian berjudul “Cara perubahan dicatat”Setiap repositori publik NextPDF mengikuti dua kontrak:
- Conventional Commits 1.0.0 — setiap subjek commit menggunakan bentuk
type(scope): description, dengantypeberupa salah satu darifeat,fix,perf,refactor,docs,test,build,ci,chore, ataurevert. Tanda!setelah type/scope, atau footerBREAKING CHANGE:, menandai perubahan yang tidak kompatibel. Perbaikan yang relevan dengan keamanan diberi tag sehingga Anda dapat memfilternya. - Semantic Versioning 2.0.0 —
featmenaikkan versi minor,fix/perfmenaikkan versi patch, dan perubahan yang merusak kompatibilitas menaikkan versi mayor.CHANGELOG.mdyang dirilis di setiap repositori mengelompokkan entri yang mudah dibaca menurut versi, dengan bagian-bagian Keep a Changelog.
Ringkasan di bawah ini hanya mencakup kategori yang berhadapan dengan pengguna: feat (kemampuan baru), fix (perilaku yang diperbaiki), perf (kinerja), security (perbaikan yang relevan dengan keamanan), dan perubahan yang merusak kompatibilitas. Tipe commit yang hanya bersifat internal (docs, test, ci, chore, refactor) sengaja tidak dimasukkan ke dalam ringkasan lintas repositori. Tipe-tipe tersebut tidak mengubah perilaku yang Anda amati saat menggunakan paket.
Tempat changelog setiap paket berada
Bagian berjudul “Tempat changelog setiap paket berada”Changelog naratif yang otoritatif untuk suatu paket adalah CHANGELOG.md di repositori paket itu sendiri, yang dikelompokkan menurut versi yang dirilis. Untuk teks entri lengkap, gunakan halaman rilis repositori atau CHANGELOG.md miliknya. Indeks ini tidak menduplikasi teks tersebut.
| Paket | Repositori | Changelog otoritatif |
|---|---|---|
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 (binding Python) | nextpdf-python | CHANGELOG.md |
Ringkasan lintas repositori — kategori per versi rilis terbaru
Bagian berjudul “Ringkasan lintas repositori — kategori per versi rilis terbaru”Tabel hanya-baca ini dihasilkan dari riwayat Conventional Commits setiap repositori pada tag rilis terbarunya. Tabel ini menghitung kategori yang berhadapan dengan pengguna, lalu melaporkan hanya jumlah per kategori — tidak pernah subjek commit mentah — sehingga tidak menampilkan pengidentifikasi internal, nama branch, atau rujukan perencanaan. Untuk detail naratif di balik setiap baris, lihat CHANGELOG.md milik paket itu sendiri.
| Paket | Rilis terbaru | Kemampuan baru (feat) | Perbaikan (fix) | Kinerja (perf) | Keamanan | Merusak kompatibilitas |
|---|---|---|---|---|---|---|
nextpdf/core | v5.2.0 | 317 | 290 | 1 | 1 | ya |
nextpdf/server | v0.1.0 | 15 | 16 | 0 | 0 | tidak |
nextpdf/laravel | v0.1.0 | 1 | 8 | 0 | 0 | tidak |
nextpdf/symfony | v0.1.0 | 1 | 7 | 0 | 0 | tidak |
nextpdf/codeigniter | v0.1.0 | 1 | 10 | 0 | 0 | tidak |
nextpdf/artisan | v0.1.0 | 1 | 7 | 0 | 0 | tidak |
nextpdf/gotenberg | v0.1.0 | 0 | 6 | 0 | 0 | tidak |
nextpdf/cloudflare | v0.1.0 | 0 | 8 | 0 | 0 | tidak |
nextpdf/compat-legacy | v0.1.0 | 1 | 8 | 0 | 0 | tidak |
nextpdf (Python) | v1.1.0 | 7 | 5 | 0 | 0 | tidak |
Jumlah bersifat kumulatif hingga tag yang disebutkan. Untuk setiap paket integrasi, rilis bertag pertama mencakup seluruh riwayat pra-1.0-nya. Sel “Breaking”
nextpdf/corebernilaiyeskarena mesin inti telah merilis versi mayor yang merusak kompatibilitas. Detail per-versi dan jalur migrasi masing-masing tersedia diCHANGELOG.mdrepositori inti dan panduanmigration/miliknya. Indeks ini tidak mengulanginya.
Apa yang sengaja tidak dicantumkan halaman ini
Bagian berjudul “Apa yang sengaja tidak dicantumkan halaman ini”Agar changelog publik tetap bebas dari kebocoran informasi internal, indeks ini tidak pernah menampilkan satu pun hal berikut:
- subjek atau isi commit mentah;
- pengidentifikasi issue, tiket, siklus, gelombang, atau item kerja internal;
- nama branch privat atau pekerjaan yang sedang berjalan dan belum dirilis;
- peta jalan atau fitur yang belum diumumkan;
- atribusi otomasi kontributor.
Sebuah perubahan hanya muncul di sini setelah menjadi bagian dari versi paket publik yang dirilis dan diberi tag. Pekerjaan yang belum dirilis tidak muncul.