URL: https://linuxfr.org/users/serge_ss_paille/journaux/changelog-pour-quoi-pour-quoi Title: Changelog, pour quoi, pour quoi ? Authors: serge_sans_paille Date: 2023年02月05日T17:07:35+01:00 License: CC By-SA Tags: changelog Score: 18 Demat'iNal, À quelques jours / semaines d'intervalles, j'ai eu besoin d'intéragir avec la notion de *Changelog*, ou plutôt de *release note*, mais je vais abusivement utiliser le premier terme pour désigner le second. 1. Un utilisateur de la bibliothèque de types vectoriels [xsimd](https://github.com/xtensor-stack/xsimd) nous a demandé d'en fournir un (ce que j'ai fait assez [diligeamment](https://github.com/xtensor-stack/xsimd/commit/da8e765ef39f07cb241159ae6d8d3e9973821fb5)) 2. Lors d'une [chouette présentation](https://fosdem.org/2023/schedule/event/llvmparcoach/) au FOSDEM hier, dans la *devroom* LLVM, quand j'ai appris que le Changelog n'était pas utilisé par les personnes faisant une mise à jour de version majeur de LLVM pour une base de code basée sur ce dernier 3. Lors de la sortie de [pythran](https://github.com/serge-sans-paille/pythran/releases/tag/0.12.1) 0.12.1, *biñs* pour laquelle j'ai écrit un Changelog comme à l'accoutumé. Mon approche personelle de l'écriture d'un changelog ne casse pas trois pattes à un canard boiteux : ``git log tag-de-debut..tag-de-fin`` dont je fais un pot pourri des titres, avec un petit tri / filtre suivant le ressenti. Pour LLVM, l'approche est plus formalisée : tout *commit* introduisant un changement visible par l'utilisateur (nouveaux drapeaux de compilation, amélioration du support d'un langage etc) se doit de mettre à jour un document qui sera utilisé lors de la release pour... documenter les changements majeurs. À titre personnel, j'éprouve une certaine satisfaction à écrire ces notes de *release* : c'est un moment où l'on tourne un peu la tête vers le passé, ce qui a été accompli, les avancées du projet... c'est aussi un moment où l'on se réjoui des contributions faites et reçues, bref c'est la fête. Par contre en tant qu'utilisateur et packageur, je les utilise rarement. Pas jamais, typiquement j'aime bien lire [celles de GCC](https://gcc.gnu.org/gcc-12/changes.html), mais sorti de ça... Bref, je suis curieux de tes retours sur ce sujet discret et anodin ?