📖 Guide complet

Comment rédiger des notes de version que les utilisateurs lisent vraiment

La plupart des changelogs sont des cimetières : des listes à puces de titres de tickets internes, publiées sur une page que personne ne visite, décrivant des changements que les utilisateurs ne remarquent jamais. Rédiger des notes de version qui font progresser l'adoption ne demande pas plus d'effort, seulement une autre forme. Voici le format, cinq modèles et les bons endroits où publier pour que vos notes soient lues.

📅 Mis à jour en novembre 2026 ⏱ 12 min de lecture ✍️ Par Kompassify
🌐 English Português Français Deutsch
Un widget de changelog in-app qui présente les notes de version aux utilisateurs dans un produit SaaS, pour voir les nouveautés sans quitter l'application

Quelque part sur votre site se trouve une page de changelog. Elle affiche une date, un numéro de version et onze puces qui commencent par des verbes comme « refactorisé » et « mis à jour ». Elle est techniquement exacte, quelqu'un a mis quarante minutes à l'assembler, et à peu près personne ne l'a lue. Pendant ce temps, la fonctionnalité enfouie à la puce sept, celle que trois clients réclamaient le trimestre dernier, reste inutilisée, parce que ceux qui l'avaient demandée n'ont jamais su qu'elle était sortie.

Les notes de version sont le canal d'adoption le plus sous-exploité de la plupart des produits SaaS. Elles sont rédigées par l'équipe qui connaît le mieux le produit, publiées selon un calendrier et lues précisément par les utilisateurs les plus susceptibles d'agir. Le problème n'est presque jamais l'effort, c'est la forme. Un journal des modifications écrit comme un compte rendu du travail d'ingénierie sera lu comme tel ; un changelog écrit pour répondre à « qu'est-ce que j'y gagne ? » génère des clics.

Ce guide explique ce que sont les release notes et en quoi elles diffèrent d'une annonce de fonctionnalité, l'anatomie en cinq parties d'une entrée, ce qu'il faut inclure et laisser de côté, cinq modèles à copier, les règles de ton et de mise en forme, le bon rythme de publication, où diffuser vos notes pour que les utilisateurs les voient vraiment, et comment savoir si tout cela a fonctionné.

À retenir

  • Les notes de version sont une documentation utilisateur, pas un résumé de sprint. Une entrée qui ressemble à un titre de ticket sera survolée comme un titre de ticket.
  • Chaque entrée a besoin de cinq parties : date ou version, un libellé de type, un titre orienté résultat, deux ou trois phrases sur le quoi et le pourquoi, et un moyen d'agir.
  • Les notes couvrent tout, les annonces couvrent l'essentiel. Publiez tous les changements dans le changelog et réservez les annonces in-app à ceux qui modifient la façon de travailler.
  • La régularité l'emporte sur la fréquence. Une entrée hebdomadaire fiable crée une habitude de lecture ; vingt micro-publications par jour apprennent aux gens à ignorer le fil.
  • C'est dans le produit que l'adoption se joue. Une page de changelog publique sert le référencement et le support ; un widget d'annonces dans le produit touche les utilisateurs qui peuvent agir en un clic.
  • Mesurez le taux de clic, pas le nombre de publications. Une entrée sur laquelle personne ne clique est une note qui n'a pas fonctionné : c'est une information, pas un échec.

Que sont les notes de version ? (Et ce qu'elles ne sont pas)

Les notes de version sont le registre continu et daté de ce qui a changé dans un produit, écrit pour ceux qui l'utilisent. Elles disent au client ce qui est nouveau, ce qui s'est amélioré, ce qui a été corrigé et ce qu'il doit éventuellement faire. C'est une documentation vivante : cumulative, chronologique et accessible en permanence par lien.

Définition des notes de version. Un registre publié des changements d'un produit, décrits en termes de résultats pour l'utilisateur, organisé par date ou par version, couvrant les nouvelles fonctionnalités, les améliorations, les corrections, les dépréciations et les changements cassants. Le test d'une bonne entrée : un client qui n'a jamais vu votre roadmap peut la lire et savoir si elle le concerne.

On les confond souvent avec trois choses voisines, et c'est cette confusion qui produit les mauvais changelogs :

Support Public Couvre Son rôle
Notes de version Tous les utilisateurs, à la demande Tout ce qui a été livré Tenir un registre complet et facile à parcourir
Annonce de fonctionnalité Un segment ciblé, de façon proactive Un changement important Faire adopter ce changement
Journal de commits Vos développeurs Chaque modification du code Expliquer le diff
Documentation produit Les utilisateurs qui cherchent à résoudre un problème L'état actuel du produit Expliquer comment utiliser ce qui existe aujourd'hui

La plupart des changelogs faibles sont des journaux de commits déguisés en notes de version. Le verbe les trahit : les entrées qui commencent par « refactorisé », « migré », « mis à niveau » ou « mis à jour le composant X » décrivent du travail, pas un changement. Or les utilisateurs n'achètent pas du travail.


Pourquoi les notes de version méritent d'être bien faites


L'anatomie d'une entrée de notes de version

Cinq parties. Oubliez-en une et l'entrée perd soit en lisibilité, soit en utilité :

Les cinq parties d'une entrée de notes de version NOUVEAU Essayer → 1. Date ou version pour pouvoir lier et citer l'entrée 2. Libellé de type Nouveau / Amélioré / Corrigé / Obsolète 3. Titre orienté résultat le bénéfice, pas le nom du ticket 4. Quoi et pour qui 2–3 phrases : ce qui change, qui est concerné 5. Un moyen d'agir lien direct, visuel, étapes de migration

Date, libellé de type, titre orienté résultat, un court « quoi et pour qui » et un moyen d'agir clair : les cinq parties dont chaque entrée a besoin.

1. La date ou la version : rendez l'entrée citable

Chaque entrée a besoin d'un ancrage stable pour que le support puisse y renvoyer, que les clients puissent la citer et que les moteurs de recherche puissent l'indexer. Pour la plupart des produits SaaS, les dates sont plus parlantes que les numéros de version sémantiques ; si vous utilisez les deux, commencez par la date.

2. Le libellé de type : laissez les gens parcourir

Quatre libellés couvrent presque tout : Nouveau, Amélioré, Corrigé, Obsolète (avec Changement cassant réservé aux changements qui exigent une action). Les libellés transforment un mur de texte en quelque chose qu'un lecteur pressé peut filtrer en deux secondes, et ils vous obligent à classer chaque changement honnêtement : un « nouveau » qui n'est en réalité qu'une amélioration se repère ici.

3. Le titre : écrivez le résultat

« Exportez vos rapports vers Google Sheets » vaut mieux que « Ajout de l'intégration Sheets » ; « Les rapports de plus de 10 000 lignes se chargent désormais en moins d'une seconde » vaut mieux que « Améliorations des performances des requêtes ». Le titre est la seule partie que la plupart des gens lisent : il doit porter à lui seul tout l'intérêt de l'entrée. C'est la même discipline qu'un bon microcopy UX : nommez ce que le lecteur y gagne.

4. Le corps : ce qui a changé, qui est concerné, pourquoi c'est important

Deux ou trois phrases, pas plus. Dites ce qui est différent, nommez les utilisateurs concernés (« les administrateurs de l'espace de travail », « tous ceux qui utilisent l'API ») et donnez la raison si elle n'est pas évidente. Si un changement ne touche qu'une offre ou une région, dites-le dès la première phrase : rien ne fait plus perdre de temps à un lecteur que de découvrir à la fin que ce n'était pas pour lui.

5. Le moyen d'agir : un lien, un visuel et des étapes si besoin

Chaque entrée qui décrit quelque chose d'utilisable doit renvoyer directement à l'endroit du produit où se trouve le changement, pas vers la page d'accueil ni vers un index de documentation. Ajoutez une capture d'écran ou un court clip pour tout ce qui est visuel : un GIF de 10 secondes fait comprendre un changement d'interface plus vite que n'importe quel paragraphe. Pour les changements cassants, ajoutez les étapes de migration et une date limite dans l'entrée elle-même.


Exemples de notes de version : avant et après

La même version, rédigée deux fois :

❌ Rédigée depuis le tableau du sprint
v4.12.3, 24 JUIL. 2026
changelog
Version 4.12.3
  • Ajout de l'intégration Sheets (PROD-2841)
  • Refactorisation du sérialiseur de rapports
  • Mise à jour des dépendances
  • Correction d'un pointeur nul à l'export
  • Amélioration des performances des requêtes
  • Retouches diverses de l'interface
Aucun lien, aucun visuel, aucune raison de cliquer
✅ Rédigée pour le lecteur
24 JUILLET 2026
Nouveau
Envoyez n'importe quel rapport directement vers Google Sheets
Les rapports peuvent désormais se synchroniser avec une feuille selon un calendrier, pour que vos chiffres de la semaine arrivent là où votre équipe travaille déjà. Disponible sur toutes les offres ; les administrateurs de l'espace de travail le connectent une seule fois dans Intégrations.
Connecter Sheets →
Également corrigé : les gros exports au-delà de 10 000 lignes n'expirent plus.

La version de gauche contient plus d'informations et communique moins. Elle cache le seul changement que les clients réclamaient au milieu d'une liste de travail interne, n'offre aucun moyen d'agir et demande au lecteur de traduire lui-même le jargon des tickets en intérêt personnel. La version de droite fait cette traduction à sa place, et renvoie vers la fonctionnalité.


5 modèles de notes de version à copier

1. Nouvelle fonctionnalité

[Titre orienté résultat]
Vous pouvez désormais [faire la chose], [le bénéfice avec les mots de l'utilisateur]. [À qui cela s'adresse et éventuelle condition d'offre ou de droits.]
[Capture d'écran ou clip de 10 secondes]
[Lien direct : « Essayer → »]

2. Amélioration

[Ce qui est désormais mieux, chiffré si possible]
[Ce qui a changé et ce que cela signifie en pratique : « les rapports de plus de 10 000 lignes se chargent désormais en moins d'une seconde, contre environ huit auparavant ».] Aucune action requise : le changement est en ligne pour tout le monde.
[Lien direct, s'il y a quelque chose à voir]

3. Correction de bug

Corrigé
• [Symptôme visible par l'utilisateur, avec ses mots] : résolu.
• [Deuxième symptôme] : résolu pour tous les espaces de travail.
Merci à toutes celles et ceux qui nous les ont signalés.

4. Changement cassant

⚠️ Changement cassant : [ce qui change], action requise avant le [date]
[Ce qui change et pourquoi.] Cela concerne [précisément qui]. Si vous [condition], vous devrez [étape 1], puis [étape 2] avant le [date]. Rien ne change pour les autres.
[Lien : guide de migration] · [Lien : contacter le support]

5. Dépréciation

[Fonctionnalité] sera retirée le [date]
Nous supprimons [fonctionnalité] parce que [raison honnête]. [Alternative à utiliser] remplit le même rôle et ajoute [différence]. Les [données/configurations] existantes [ce qu'elles deviennent].
[Lien : comment migrer]

Deux règles valent pour les cinq : n'enfouissez jamais un changement cassant dans une liste de fonctionnalités, et ne publiez jamais une dépréciation sans nommer l'alternative et la date dans les deux premières lignes.


Ton, mise en forme et rythme de publication

Écrivez comme un collègue qui explique, pas comme un système qui rapporte

Langage simple, voix active, présent : « Vous pouvez désormais exporter vers Sheets », pas « L'export vers Sheets a été implémenté ». Oubliez les adjectifs de célébration comme « passionnant », « révolutionnaire » ou « qui change la donne » : ils vous coûtent de la crédibilité chaque fois que le changement se révèle ordinaire. L'enthousiasme doit venir du fond, pas des adverbes.

Mettez en forme pour la lecture en diagonale, car c'est ce qui se passe

Titres en gras orientés résultat, libellés de type, paragraphes courts, espaces généreux, une idée par entrée. Regroupez plusieurs changements sous des intertitres (Nouveau / Amélioré / Corrigé) plutôt que dans une longue liste. Et gardez des entrées visuellement cohérentes, pour qu'un lecteur fidèle sache exactement où chercher la partie qui l'intéresse.

Publiez à un rythme sur lequel on peut compter

Un rythme hebdomadaire ou bimensuel convient à la plupart des équipes SaaS qui livrent en continu ; une publication par version convient aux cycles plus lents. Ce qui compte, c'est la régularité : un changelog qui paraît tous les jeudis crée une habitude, un changelog qui paraît quand quelqu'un y pense n'en crée aucune. Regroupez les petits changements dans une seule entrée datée plutôt que de les publier un par un.

Laissez le travail interne de côté

Refactorisations, mises à jour de dépendances, couverture de tests, migrations d'infrastructure : c'est invisible pour les utilisateurs, donc cela n'a pas sa place dans des notes qui leur sont destinées. L'exception : quand ce travail interne a produit un résultat visible. Écrivez alors le résultat (« les imports sont environ deux fois plus rapides »), pas le mécanisme.

Soyez honnête sur les mauvaises nouvelles

Dépréciations, changements de prix, limites, fonctionnalités qui n'ont pas marché. Les publier simplement, au même endroit que les bonnes nouvelles, c'est ce qui rend les bonnes nouvelles crédibles. Les utilisateurs l'apprendront de toute façon : la seule question est de savoir s'ils l'apprennent d'abord de vous.


Où publier vos notes de version pour qu'elles soient vues

Une page de changelog seule ne touche que le petit groupe qui vient la chercher. La couverture vient de la superposition de plusieurs canaux, chacun avec son rôle :

Canal Touche Idéal pour
Page de changelog publique Prospects, support, personnes qui cherchent Le registre complet, permanent et accessible par lien
Widget d'annonces in-app Utilisateurs actifs, dans le produit Faire progresser l'adoption, à un clic de la fonctionnalité
Annonce ciblée ou modale Un segment ciblé, immédiatement Les rares changements qui modifient la façon de travailler
Récapitulatif par e-mail Utilisateurs qui ne se connectent plus Bilans mensuels et réactivation
Une courte visite produit Utilisateurs sur l'écran concerné Les changements complexes qui demandent un accompagnement
Adaptez le canal à l'ampleur du changement Chaque entrée va dans le changelog. Seules les plus importantes montent plus haut. PLUS D'ATTENTION CORRIGÉ Page changelog AMÉLIORÉ + Fil in-app Vu des utilisateurs actifs, à un clic NOUVEAU + Annonce ciblée Seulement pour le segment concerné NOUVEAU WORKFLOW + Courte visite produit Montre le changement là où il se trouve

Faites monter selon l'impact : les corrections restent dans le changelog, les améliorations arrivent dans le fil in-app, les nouvelles capacités ont droit à une annonce ciblée et les changements de workflow à une courte visite guidée.

La ligne in-app est celle où la plupart des équipes investissent le moins, et celle qui fait bouger l'adoption. Un utilisateur qui découvre une nouvelle option d'export pendant qu'il est dans le produit est à un clic de l'utiliser ; la même personne qui lit les mêmes mots dans un e-mail un dimanche ne l'est pas. Pour les rares changements qui modifient vraiment un workflow, montez d'un cran : associez la note à une annonce ciblée et, si c'est réellement complexe, à une courte visite produit qui guide les utilisateurs dans le changement au lieu de le décrire.

Une annonce in-app qui présente une note de version aux utilisateurs dans le produit, avec un lien direct vers la nouvelle fonctionnalité
(Le volet in-app d'un changelog : la note atteint les utilisateurs là où ils peuvent agir, pas dans une boîte de réception qu'ils liront lundi)

Et segmentez sans pitié. Une note sur une intégration réservée aux administrateurs, montrée à tous les utilisateurs standards, est du bruit qui vous coûtera de l'attention à la prochaine entrée ; la même note montrée uniquement aux administrateurs est utile. La même segmentation qui rend l'onboarding pertinent rend les notes de version lisibles.


Comment savoir si vos notes de version fonctionnent

« Nous avons publié à temps » est une production, pas un résultat. Quatre chiffres vous disent si vos notes ont servi à quelque chose :

Analytics des notes de version et annonces in-app montrant les vues et les clics pour chaque entrée
(Vues et clics par entrée : toute la différence entre un changelog que l'on publie et un changelog qui fonctionne)

Attention à la lassitude du changelog. Si le taux de lecture baisse régulièrement alors que votre volume de publication reste stable, vous dépensez l'attention plus vite que vous ne la gagnez, généralement en annonçant tout avec la même intensité. La solution, c'est le tri, pas davantage de points d'exclamation : la plupart des changements méritent une ligne dans les notes, quelques-uns une annonce in-app, et un ou deux par trimestre une visite guidée.


Notes de version : à faire et à éviter

✅ À faire

  • Donner à chaque entrée un titre qui nomme le résultat visible
  • Classer les changements en Nouveau / Amélioré / Corrigé / Obsolète
  • Nommer précisément qui est concerné par chaque changement
  • Renvoyer directement vers la fonctionnalité, pas vers la page d'accueil
  • Ajouter une capture ou un court clip pour les changements visuels
  • Publier à un rythme prévisible
  • Diffuser les notes dans le produit, pas seulement sur une page web
  • Suivre les clics et l'adoption pour chaque entrée

❌ À éviter

  • Coller des titres de tickets ou des messages de commit
  • Lister les refactorisations internes et les mises à jour de dépendances
  • Enfouir un changement cassant dans une liste de fonctionnalités
  • Publier une dépréciation sans date ni alternative
  • Qualifier chaque changement de passionnant ou de révolutionnaire
  • Envoyer chaque entrée à tous les utilisateurs, quelle que soit leur offre
  • Publier vingt micro-entrées dans la même journée
  • Mesurer le succès au nombre de notes publiées

Publier des notes de version in-app sans mobiliser les développeurs

La page de changelog publique est généralement simple ; c'est le volet in-app (un widget d'annonces, des annonces ciblées, le statut de lecture par utilisateur, le suivi des clics) qui bloque les équipes, parce que c'est du travail front-end qui ne passe jamais tout à fait devant la roadmap. Avec Kompassify, cette couche fonctionne par-dessus votre produit existant, sans code :

Kompassify est conforme au RGPD et hébergé dans l'UE, gratuit jusqu'à 100 utilisateurs actifs mensuels, avec des offres payantes à partir de $129/mois.

Transformez votre changelog en adoption

Kompassify vous permet de publier vos notes de version dans votre produit, de transformer les plus importantes en annonces ciblées et de lancer une visite produit directement depuis une entrée, sans code ni cycle de mise en production. Voyez quelles notes sont lues et lesquelles génèrent un usage réel. Conforme au RGPD, hébergé dans l'UE et gratuit jusqu'à 100 utilisateurs actifs mensuels.

Commencer gratuitement →

Questions fréquentes

Que sont les notes de version ?

Les notes de version (ou release notes) sont le registre continu de ce qui a changé dans un produit et de ce que cela signifie pour ses utilisateurs, publié à chaque livraison, le plus souvent sous forme d'entrée datée dans un changelog. Elles couvrent les nouvelles fonctionnalités, les améliorations, les corrections, les changements cassants et les dépréciations. La distinction qui compte : les notes de version sont une documentation écrite pour les utilisateurs, pas un résumé de votre sprint. Une liste de tickets fusionnés est un journal de commits ; les notes de version traduisent ces changements en résultats qu'un client peut reconnaître.

Quelle différence entre des notes de version et une annonce de fonctionnalité ?

La portée et l'intention. Les notes de version sont le registre complet et continu : tout ce qui a été livré, y compris les petites corrections, publié à un rythme prévisible pour ceux qui veulent savoir. Une annonce de fonctionnalité est une campagne autour d'un seul changement important, conçue pour toucher des utilisateurs qui ne le cherchent pas : une modale in-app, un e-mail, une visite guidée qui mène les gens vers la nouvelle capacité. Chaque annonce devrait s'appuyer sur une note de version ; la plupart des notes de version ne méritent pas d'annonce. Utilisez les notes pour la couverture et les annonces pour les rares changements qui modifient vraiment la façon de travailler de quelqu'un.

Que doit contenir une note de version ?

Cinq éléments : une date ou un numéro de version pour pouvoir citer l'entrée ; un libellé de type (nouveau, amélioré, corrigé, obsolète) pour faciliter la lecture en diagonale ; un titre en langage clair qui nomme le résultat visible pour l'utilisateur ; deux ou trois phrases sur ce qui a changé, qui est concerné et pourquoi c'est important ; et un moyen d'agir : un lien direct vers la fonctionnalité, une capture d'écran ou un court clip, et les étapes de migration si quelque chose casse. Tout ce qui n'aide pas un utilisateur à décider si cela le concerne a sa place dans votre outil de suivi interne, pas dans le changelog.

À quelle fréquence publier des notes de version ?

À un rythme prévisible plutôt qu'à chaque déploiement. Les équipes qui livrent en continu regroupent généralement les changements dans une entrée hebdomadaire ou bimensuelle ; les cycles plus lents publient à chaque version. La régularité compte plus que la fréquence : les lecteurs ne prennent l'habitude de consulter le changelog que si les entrées arrivent quand ils les attendent. Si vous livrez beaucoup de petites choses, regroupez-les sous une seule entrée datée avec des sections : vingt micro-entrées dans la journée apprennent aux gens à ignorer le fil.

Faut-il inclure les corrections de bugs dans les notes de version ?

Oui, mais résumées et séparées. Les utilisateurs qui ont rencontré un bug veulent la preuve qu'il est corrigé, et une section de corrections visible renforce réellement la crédibilité. Ce qui n'a pas sa place, c'est la liste brute : « correction d'un pointeur nul dans le sérialiseur de rapports » ne veut rien dire en dehors de votre équipe. Regroupez-les sous un titre Corrigé, décrivez-les avec les mots de l'utilisateur (« Les rapports de plus de 10 000 lignes n'expirent plus ») et laissez complètement de côté les refactorisations internes, les mises à jour de dépendances et les modifications de tests.

Où publier les notes de version ?

Au moins à deux endroits : une page de changelog publique et accessible par lien pour le référencement, le support et les prospects, et une surface in-app pour que les utilisateurs existants découvrent les nouveautés là où ils se trouvent déjà, généralement un widget d'annonces ou un panneau « Nouveautés ». C'est la version in-app qui fait vraiment progresser l'adoption, car elle touche les gens dans le produit, à un clic de la fonctionnalité. Pour les rares changements qui modifient la façon de travailler, ajoutez par-dessus une annonce ciblée ou une courte visite guidée.

Comment publier des notes de version dans votre application sans mobiliser les développeurs ?

Avec une plateforme no-code comme Kompassify, vous gérez vous-même le volet in-app de votre changelog : publiez des entrées dans un widget d'annonces, mettez en avant les changements qui le méritent avec une annonce ciblée, ciblez-les par segment d'utilisateurs pour que chacun ne voie que ce qui le concerne, et lancez une visite produit directement depuis une entrée pour guider les utilisateurs vers la nouvelle fonctionnalité. Les analytics intégrés montrent qui a lu et qui a cliqué, pour savoir quelles notes ont fait progresser l'adoption. Kompassify est conforme au RGPD et hébergé dans l'UE, gratuit jusqu'à 100 utilisateurs actifs mensuels, avec des offres payantes à partir de $129/mois.