Changelog
Changelog
Sezione intitolata “Changelog”L’ecosistema NextPDF comprende molti pacchetti distribuiti su più repository. Questa pagina è l’indice cross-repo di come vengono registrate le modifiche e di dove si trova il changelog di ciascun pacchetto. Va intesa come indice e riferimento per le convenzioni, non come riscrittura di ogni commit. Ogni pacchetto mantiene, nel proprio repository, il changelog autorevole delle versioni rilasciate. La tabella di riepilogo aggrega soltanto la categoria di modifica per versione rilasciata, ricavata dalla cronologia Conventional Commits di ciascun repository.
In quanto indice della documentazione, questa pagina non formula affermazioni sul comportamento di alcun pacchetto. Per leggere le regole seguite da ciascun pacchetto nella scrittura dei commit e nell’emissione dei rilasci, vedere Convenzioni del changelog.
Come vengono registrati i cambiamenti
Sezione intitolata “Come vengono registrati i cambiamenti”Ogni repository pubblico di NextPDF segue due contratti:
- Conventional Commits 1.0.0 — ogni oggetto del commit assume la forma
type(scope): description, dovetypeè uno trafeat,fix,perf,refactor,docs,test,build,ci,choreorevert. Un!dopo il type/scope, oppure un footerBREAKING CHANGE:, indica una modifica incompatibile. Le correzioni rilevanti per la sicurezza sono contrassegnate, così da renderle filtrabili. - Semantic Versioning 2.0.0 — un
featincrementa la versione minor, unfix/perfincrementa la versione patch e una modifica incompatibile incrementa la versione major. IlCHANGELOG.mdrilasciato in ciascun repository raggruppa per versione le voci destinate alla lettura umana, utilizzando le sezioni Keep a Changelog.
Il riepilogo riportato di seguito copre soltanto le categorie rivolte all’utente: feat (nuova funzionalità), fix (comportamento corretto), perf (prestazioni), security (correzione rilevante per la sicurezza) e le modifiche incompatibili. I tipi di commit di sola rilevanza interna (docs, test, ci, chore, refactor) sono volutamente esclusi dal riepilogo cross-repo. Non modificano ciò che osserva chi utilizza il pacchetto.
Dove si trova il changelog di ciascun pacchetto
Sezione intitolata “Dove si trova il changelog di ciascun pacchetto”Il changelog autorevole, in prosa, di un pacchetto è il CHANGELOG.md nel repository del pacchetto stesso, raggruppato per versione rilasciata. Per il testo completo delle voci, utilizzare la pagina dei rilasci del repository oppure il suo CHANGELOG.md. Questo indice non ne duplica il testo.
| Pacchetto | Repository | Changelog autorevole |
|---|---|---|
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 |
Riepilogo cross-repo — categorie per l’ultima versione rilasciata
Sezione intitolata “Riepilogo cross-repo — categorie per l’ultima versione rilasciata”Questa tabella è generata in modalità sola lettura. Legge la cronologia Conventional Commits di ciascun repository fino al suo ultimo tag rilasciato e conteggia le categorie rivolte all’utente. Riporta soltanto i conteggi per categoria — mai gli oggetti grezzi dei commit — così da non esporre alcun identificatore interno, nome di ramo o riferimento di pianificazione. Per il dettaglio in prosa di qualsiasi riga, consultare il CHANGELOG.md del pacchetto stesso.
| Pacchetto | Ultima rilasciata | Nuova funzionalità (feat) | Correzioni (fix) | Prestazioni (perf) | Sicurezza | Incompatibili |
|---|---|---|---|---|---|---|
nextpdf/core | v5.2.0 | 317 | 290 | 1 | 1 | sì |
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 |
I conteggi sono cumulativi fino al tag indicato. Per ciascun pacchetto di integrazione il primo rilascio con tag include l’intera cronologia precedente alla 1.0. La cella «Incompatibili» di
nextpdf/coreriportayesperché il motore core ha pubblicato versioni major incompatibili. I dettagli per versione e il percorso di migrazione per ciascuna di esse sono disponibili nelCHANGELOG.mddel repository core e nelle sue guidemigration/. Questo indice non li riformula.
Ciò che questa pagina omette deliberatamente
Sezione intitolata “Ciò che questa pagina omette deliberatamente”Per mantenere il changelog pubblico libero da esposizioni di informazioni interne, questo indice non espone mai nulla di quanto segue:
- oggetti o corpi grezzi dei commit;
- identificatori interni di issue, ticket, ciclo, wave o work item;
- nomi di rami privati o lavori non rilasciati in corso;
- roadmap o funzionalità non annunciate;
- attribuzione dell’automazione dei contributi.
Una modifica diventa visibile qui solo quando fa parte di una versione di un pacchetto pubblico rilasciata e con tag. Il lavoro non rilasciato non compare.