Ingénierie
Le changelog comme artefact de build : conventions, automatisation, pipelines.
Pour commencer : Keep a Changelog expliqué, avec un modèle CHANGELOG.md, Des conventional commits à un changelog, Automatisation du changelog : quoi automatiser, quoi éviter
-
Qu'est-ce qu'un hotfix ? Définition, hotfix vs patch
Un hotfix est un correctif urgent livré hors du cycle de release normal. Sa définition, sa différence avec un patch, et comment le livrer en sécurité.
Ingénierie7 min de lecture
-
Release candidate (RC) : définition et mode d'emploi
Une release candidate est un build livré en version finale sauf blocage trouvé par les tests. Sa place après la bêta, son versionnage et sa sortie.
Ingénierie5 min de lecture
-
CHANGELOG.md : ce qu'il contient et comment le garder à jour
Un CHANGELOG.md est le registre côté lecteur de ce qui a changé par version. Les sections à prévoir, un exemple complet et l'habitude qui le garde à jour.
Ingénierie6 min de lecture
-
Release notes GitHub : les générer, puis les rendre lisibles
GitHub rédige un brouillon de release notes depuis les pull requests. Ce qu'il contient, ce que change release.yml et la relecture qui le rend lisible.
Ingénierie7 min de lecture
-
Release management : processus pour équipes qui livrent vite
Un processus de release management en sept étapes, avec responsable et critères de sortie, plus les métriques DORA et un KPI supplémentaire à suivre.
Ingénierie8 min de lecture
-
Qui écrit le changelog, et qui devrait l'écrire
Qui écrit le changelog ? L'autrice de la PR sait ce qui a changé, la PM pourquoi ça compte. Seule, aucune n'écrit une entrée vraiment utile aux clients.
Ingénierie6 min de lecture
-
Formats de fichier changelog : JSON, YAML ou juste Markdown
Le format d'un fichier changelog décide s'il alimente une page et un widget, ou n'est lu que par une personne. Markdown, JSON et YAML coûtent différemment.
Ingénierie6 min de lecture
-
Exiger une entrée de changelog avec GitHub Actions
Un check de changelog dans GitHub Actions refuse de merger sans entrée, car une étape qui dépend de la mémoire échoue à coup sûr. Et ce que ce check casse.
Ingénierie6 min de lecture
-
Tags Git vs releases GitHub vs changelog
Un tag git, une release, une entrée de changelog : trois enregistrements d'un événement. Les confondre fait dériver le changelog. Comment les accorder.
Ingénierie6 min de lecture
-
Changelogs de monorepo : un seul, ou un par package ?
Un monorepo peut avoir un changelog pour tout le repo ou un par package, et se tromper rend chaque release trop bruyante ou trop dispersée à trouver.
Ingénierie6 min de lecture
-
Semantic versioning et changelog : le sens de chaque saut
Le semantic versioning dit combien une release peut faire mal avant qu'on lise le changelog. Ce que chaque chiffre promet, et ce qu'une entrée doit tenir.
Ingénierie6 min de lecture
-
Page de changelog publique : la construire, la faire suivre
Une page de changelog vaut la peine quand quelqu'un y revient. Où elle vit, ce dont une entrée a besoin, flux et balisage, et la place du widget.
Ingénierie7 min de lecture
-
Automatisation du changelog : quoi automatiser, quoi éviter
Automatisez collecte, formatage et publication. N'automatisez ni la sélection ni la formulation. Où se situe la ligne et ce qui arrive quand elle bouge.
Ingénierie7 min de lecture
-
Des conventional commits à un changelog
Les conventional commits rendent un changelog dérivable, pas lisible. Ce que la convention apporte, où elle s'arrête, et comment combler l'écart.
Ingénierie7 min de lecture
-
Keep a Changelog expliqué, avec un modèle CHANGELOG.md
La spec Keep a Changelog tient en une page et se lit en dix minutes. Les équipes dérivent en l'appliquant. Ce qu'elle dit, ce qu'elle laisse ouvert.
Ingénierie6 min de lecture