Aller au contenu

Journal des modifications

L’écosystème NextPDF s’étend sur de nombreux paquets répartis dans de multiples dépôts. Cette page est l’index inter-dépôts qui explique comment les modifications sont consignées et où se trouve le journal des modifications propre à chaque paquet. Considère-la comme un index et comme une référence pour les conventions, pas comme une reformulation de chaque commit. Chaque paquet conserve son journal des modifications publié et faisant autorité dans son propre dépôt. Le tableau de synthèse présenté ici n’agrège que la catégorie de modification par version publiée, dérivée de l’historique Conventional Commits de chaque dépôt.

En tant qu’index documentaire, cette page n’émet aucune affirmation sur le comportement d’un paquet. Pour connaître les règles que chaque paquet suit lorsqu’il rédige un commit et publie une version, voir Conventions du journal des modifications.

Chaque dépôt public NextPDF respecte deux contrats :

  • Conventional Commits 1.0.0 — chaque sujet de commit suit la forme type(scope): description, où type prend l’une des valeurs suivantes : feat, fix, perf, refactor, docs, test, build, ci, chore ou revert. Un ! placé après le type/scope ou un pied de page BREAKING CHANGE: signale une modification incompatible. Les correctifs relatifs à la sécurité sont étiquetés afin que tu puisses les filtrer.
  • Versionnage sémantique 2.0.0 — un commit feat incrémente la version mineure, un commit fix/perf incrémente la version corrective, et une modification incompatible incrémente la version majeure. Le CHANGELOG.md publié dans chaque dépôt regroupe les entrées lisibles par version, selon les sections de Keep a Changelog.

Le résumé ci-dessous ne couvre que les catégories visibles pour l’utilisateur : feat (nouvelle capacité), fix (comportement corrigé), perf (performance), security (correctif relatif à la sécurité), et les modifications incompatibles. Les types de commit purement internes (docs, test, ci, chore, refactor) sont volontairement exclus du résumé inter-dépôts ; ils ne changent rien à ce qu’observe un consommateur du paquet.

Où se trouve le journal des modifications de chaque paquet

Section intitulée « Où se trouve le journal des modifications de chaque paquet »

Pour chaque paquet, le journal des modifications faisant autorité est le CHANGELOG.md rédigé en prose dans son propre dépôt, avec des entrées regroupées par version publiée. Pour le texte complet d’une entrée, consulte la page de publication du dépôt ou son CHANGELOG.md. Cet index ne reproduit pas ce texte.

PaquetDépôtJournal des modifications faisant autorité
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 (liaisons Python)nextpdf-pythonCHANGELOG.md

Résumé inter-dépôts — catégories par dernière version publiée

Section intitulée « Résumé inter-dépôts — catégories par dernière version publiée »

Ce tableau est généré en lecture seule. Il lit l’historique Conventional Commits de chaque dépôt jusqu’à son dernier tag publié et compte les catégories visibles pour l’utilisateur. Il ne rapporte que les décomptes par catégorie — jamais les sujets de commit bruts — afin qu’aucun identifiant interne, nom de branche ou référence de planification ne soit exposé. Pour lire le détail rédigé d’une ligne, suis le CHANGELOG.md du paquet concerné.

PaquetDernière version publiéeNouvelle capacité (feat)Correctifs (fix)Performance (perf)SécuritéIncompatible
nextpdf/corev5.2.031729011oui
nextpdf/serverv0.1.0151600non
nextpdf/laravelv0.1.01800non
nextpdf/symfonyv0.1.01700non
nextpdf/codeigniterv0.1.011000non
nextpdf/artisanv0.1.01700non
nextpdf/gotenbergv0.1.00600non
nextpdf/cloudflarev0.1.00800non
nextpdf/compat-legacyv0.1.01800non
nextpdf (Python)v1.1.07500non

Les décomptes sont cumulatifs jusqu’au tag indiqué. Pour chaque paquet d’intégration, la première version taguée inclut tout son historique antérieur à la 1.0. La cellule « Incompatible » de nextpdf/core équivaut à yes, car le moteur central a livré des versions majeures incompatibles. Le détail par version et le parcours de migration de chacune se trouvent dans le CHANGELOG.md du dépôt central et dans ses guides migration/. Cet index ne les reformule pas.

Ce que cette page laisse délibérément de côté

Section intitulée « Ce que cette page laisse délibérément de côté »

Pour éviter toute fuite interne dans le journal des modifications public, cet index n’expose jamais les éléments suivants :

  • les sujets ou corps de commit bruts ;
  • les identifiants internes de tickets, de problèmes, de cycles, de vagues ou d’éléments de travail ;
  • les noms de branches privées ou les travaux non publiés en cours ;
  • la feuille de route ou les fonctionnalités non annoncées ;
  • les mentions d’attribution générées par l’automatisation pour les contributeurs.

Une modification ne devient visible ici qu’après avoir été intégrée à une version publiée et taguée d’un paquet public. Les travaux non publiés n’apparaissent pas.