Ga naar inhoud

Changelog

Het NextPDF-ecosysteem omvat meerdere pakketten en repository’s. Deze pagina laat zien hoe het ecosysteem wijzigingen vastlegt en waar elk pakket zijn eigen changelog bijhoudt. Gebruik deze pagina als index en naslagwerk voor de conventies, niet als volledige herhaling van elke commit. Elk pakket houdt de gezaghebbende releasechangelog bij in de eigen repository. De samenvattingstabel bundelt uitsluitend de wijzigingscategorie per uitgebrachte versie, afgeleid uit de Conventional Commits-geschiedenis van elke repository.

Als documentatie-index doet deze pagina geen uitspraken over pakketgedrag. Raadpleeg Changelog-conventies voor de regels die elk pakket volgt bij het schrijven van commits en het uitbrengen van releases.

Elke publieke NextPDF-repository volgt twee afspraken:

  • Conventional Commits 1.0.0 — elk commitonderwerp gebruikt de vorm type(scope): description, waarbij type een van de volgende waarden is: feat, fix, perf, refactor, docs, test, build, ci, chore of revert. Een ! na type/scope, of een BREAKING CHANGE:-footer, markeert een incompatibele wijziging. Beveiligingsrelevante fixes worden getagd, zodat je erop kunt filteren.
  • Semantic Versioning 2.0.0 — een feat verhoogt de minorversie, een fix/perf verhoogt de patchversie en een ingrijpende wijziging verhoogt de majorversie. De gepubliceerde CHANGELOG.md in elke repository groepeert leesbare vermeldingen per versie, volgens de secties van Keep a Changelog.

De onderstaande samenvatting omvat uitsluitend gebruikersgerichte categorieën: feat (nieuwe mogelijkheid), fix (gecorrigeerd gedrag), perf (prestaties), security (beveiligingsrelevante fix) en ingrijpende wijzigingen. Interne committypen (docs, test, ci, chore, refactor) worden bewust buiten de cross-repo-samenvatting gelaten. Ze veranderen niets aan het waarneembare gedrag bij gebruik van het pakket.

De gezaghebbende changelogtekst voor een pakket is de CHANGELOG.md in de eigen repository van dat pakket, gegroepeerd per uitgebrachte versie. Raadpleeg de releasepagina van de repository of de bijbehorende CHANGELOG.md voor de volledige tekst van een vermelding. Deze index dupliceert die tekst niet.

PakketRepositoryGezaghebbende changelog
nextpdf/corenextpdfCHANGELOG.md (Keep a Changelog)
nextpdf/servernextpdf-serverCHANGELOG.md
nextpdf/laravelnextpdf-LaravelCHANGELOG.md
nextpdf/symfonynextpdf-SymfonyCHANGELOG.md
nextpdf/codeigniternextpdf-CodeIgniterCHANGELOG.md
nextpdf/artisannextpdf-ArtisanCHANGELOG.md
nextpdf/gotenbergnextpdf-GotenbergCHANGELOG.md
nextpdf/cloudflarenextpdf-CloudflareCHANGELOG.md
nextpdf/compat-legacynextpdf-compat-tcpdfCHANGELOG.md
nextpdf (Python-bindings)nextpdf-pythonCHANGELOG.md

Cross-repo-samenvatting — categorieën per laatst uitgebrachte versie

Sectie met titel “Cross-repo-samenvatting — categorieën per laatst uitgebrachte versie”

Deze alleen-lezen tabel wordt gegenereerd uit de Conventional Commits-geschiedenis van elke repository tot en met de laatst uitgebrachte tag. De tabel telt de gebruikersgerichte categorieën en geeft uitsluitend categorietellingen weer — nooit ruwe commitonderwerpen — zodat er geen interne identifiers, branchnamen of planningsverwijzingen worden prijsgegeven. Raadpleeg de CHANGELOG.md van het pakket zelf voor de uitgeschreven details bij een regel.

PakketLaatst uitgebrachtNieuwe mogelijkheid (feat)Fixes (fix)Prestaties (perf)BeveiligingIngrijpend
nextpdf/corev5.2.031729011ja
nextpdf/serverv0.1.0151600nee
nextpdf/laravelv0.1.01800nee
nextpdf/symfonyv0.1.01700nee
nextpdf/codeigniterv0.1.011000nee
nextpdf/artisanv0.1.01700nee
nextpdf/gotenbergv0.1.00600nee
nextpdf/cloudflarev0.1.00800nee
nextpdf/compat-legacyv0.1.01800nee
nextpdf (Python)v1.1.07500nee

De tellingen zijn cumulatief tot en met de genoemde tag. Voor elk integratiepakket bevat de eerste getagde release de volledige pre-1.0-geschiedenis. De cel “Breaking” bij nextpdf/core staat op yes omdat de core-engine ingrijpende majorversies heeft uitgebracht. De versiespecifieke details en het migratiepad voor elk van die versies staan in de CHANGELOG.md van de core-repository en in de bijbehorende migration/-handleidingen. Deze index herhaalt die details niet.

Om te voorkomen dat de publieke changelog interne informatie prijsgeeft, toont deze index nooit een van de volgende zaken:

  • ruwe commitonderwerpen of committeksten;
  • interne issue-, ticket-, cyclus-, wave- of werkitem-identifiers;
  • private branchnamen of niet-uitgebracht werk in uitvoering;
  • roadmapitems of niet-aangekondigde functies;
  • vermeldingen van automatisering rond bijdragen.

Een wijziging verschijnt hier pas nadat die onderdeel is geworden van een uitgebrachte, getagde versie van een publiek pakket. Niet-uitgebracht werk verschijnt hier niet.