Zum Inhalt springen

Changelog

Das NextPDF-Ökosystem umfasst zahlreiche Pakete in mehreren Repositories. Diese Seite ist der repoübergreifende Index dazu, wie Änderungen dokumentiert werden und wo das jeweilige Changelog eines Pakets liegt. Betrachten Sie sie als Index und Konventionsreferenz, nicht als erneute Wiedergabe jedes einzelnen Commits. Jedes Paket führt sein maßgebliches, veröffentlichtes Changelog in seinem jeweiligen Repository. Die Übersichtstabelle auf dieser Seite aggregiert nur die Kategorie der Änderung je veröffentlichter Version, abgeleitet aus der Conventional-Commits-Historie des jeweiligen Repositories.

Als Dokumentationsindex trifft diese Seite keine Verhaltensaussage über irgendein Paket. Die Regeln, denen jedes Paket beim Verfassen eines Commits und beim Erstellen eines Releases folgt, finden Sie unter Changelog-Konventionen.

Jedes öffentliche NextPDF-Repository folgt zwei verbindlichen Vorgaben:

  • Conventional Commits 1.0.0 — jede Commit-Betreffzeile hat die Form type(scope): description, wobei type eines von feat, fix, perf, refactor, docs, test, build, ci, chore oder revert ist. Ein ! nach type/scope oder ein BREAKING CHANGE:-Footer kennzeichnet eine inkompatible Änderung. Sicherheitsrelevante Fixes werden markiert, damit Sie nach ihnen filtern können.
  • Semantische Versionierung 2.0.0 — ein feat erhöht die Minor-Version, ein fix/perf erhöht die Patch-Version, und eine Breaking Change erhöht die Major-Version. Die in jedem Repository veröffentlichte CHANGELOG.md gruppiert die menschenlesbaren Einträge nach Version und verwendet dabei die Abschnittsstruktur von Keep a Changelog.

Die Zusammenfassung unten deckt nur die nutzersichtbaren Kategorien ab: feat (neue Fähigkeit), fix (korrigiertes Verhalten), perf (Performance), security (sicherheitsrelevanter Fix) und Breaking Changes. Rein interne Commit-Typen (docs, test, ci, chore, refactor) bleiben in der repoübergreifenden Zusammenfassung bewusst unberücksichtigt. Sie ändern nichts an dem, was ein Nutzer des Pakets beobachtet.

Das maßgebliche, in Prosa verfasste Changelog für ein Paket ist die CHANGELOG.md im jeweiligen Repository, gruppiert nach veröffentlichter Version. Den vollständigen Eintragstext finden Sie auf der Release-Seite des Repositories oder in dessen CHANGELOG.md. Dieser Index dupliziert diesen Text nicht.

PaketRepositoryMaßgebliches 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

Repoübergreifende Zusammenfassung — Kategorien je zuletzt veröffentlichter Version

Abschnitt betitelt „Repoübergreifende Zusammenfassung — Kategorien je zuletzt veröffentlichter Version“

Diese Tabelle wird als schreibgeschützte Ausgabe generiert. Sie liest die Conventional-Commits-Historie jedes Repositories an dessen zuletzt veröffentlichtem Git-Tag und zählt die nutzersichtbaren Kategorien. Sie gibt nur Kategoriezählungen aus — niemals rohe Commit-Betreffzeilen — sodass keine internen Bezeichner, Branch-Namen oder Planungsverweise sichtbar werden. Für die ausformulierten Details einer beliebigen Zeile folgen Sie der paketeigenen CHANGELOG.md.

PaketZuletzt veröffentlichtNeue Fähigkeit (feat)Fixes (fix)Performance (perf)SicherheitBreaking
nextpdf/corev5.2.031729011ja
nextpdf/serverv0.1.0151600nein
nextpdf/laravelv0.1.01800nein
nextpdf/symfonyv0.1.01700nein
nextpdf/codeigniterv0.1.011000nein
nextpdf/artisanv0.1.01700nein
nextpdf/gotenbergv0.1.00600nein
nextpdf/cloudflarev0.1.00800nein
nextpdf/compat-legacyv0.1.01800nein
nextpdf (Python)v1.1.07500nein

Die Zählungen sind kumulativ bis zum genannten Git-Tag. Für jedes Integrations- paket enthält das erste getaggte Release dessen vollständige Vor-1.0-Historie. Die “Breaking”-Zelle von nextpdf/core weist yes aus, weil die Core-Engine Breaking-Majors ausgeliefert hat. Die Details je Version und der Migrationspfad für jede einzelne liegen in der CHANGELOG.md des Core-Repositories und in dessen migration/-Anleitungen. Dieser Index gibt sie nicht erneut wieder.

Damit im öffentlichen Changelog keine internen Informationen durchsickern, legt dieser Index keines der folgenden Dinge offen:

  • rohe Commit-Betreffzeilen oder -Rümpfe;
  • interne Issue-, Ticket-, Zyklus-, Wave- oder Arbeitselement-Bezeichner;
  • private Branch-Namen oder laufende unveröffentlichte Arbeit;
  • Roadmap oder nicht angekündigte Funktionen;
  • Attribution von Contributor-Automatisierung.

Eine Änderung wird hier erst sichtbar, sobald sie Teil einer veröffentlichten, getaggten Version eines öffentlichen Pakets ist. Unveröffentlichte Arbeit erscheint nicht.