Écrire des notes de mise à jour de produits efficaces (+ exemples réels et modèles)

Toute personne qui s’occupe de la rédaction de notes de mise à jour de produits les trouve fastidieuses, ennuyeuses et chronophages. Vous voyez souvent des gens qui les fuient littéralement. Mais gardez à l’esprit qu’il est important de publier des notes de mise à jour de produits et de maintenir votre changelog à jour pour la croissance de votre entreprise. Dans cet article, nous nous pencherons également sur les modèles de notes de mise à jour.

En plus de gérer un service de changelog, nous nous occupons aussi très souvent des notes de mise à jour. Nous continuons à mettre à jour nos utilisateurs sur les améliorations récentes des changements que nous avons fait sur notre produit. Par conséquent, nous avons développé des techniques sur la façon de rendre l’ensemble du processus plus supportable et efficace.

Qu’est-ce que les notes de version ?

Les notes de version sont un document sous forme de liste à puces qui accompagne une version de logiciel pour dire aux utilisateurs ce qui a changé. Bien qu’il n’y ait pas de format universel, les notes de mise à jour typiques comprennent des informations sur les corrections de bogues, les nouvelles fonctionnalités et parfois les problèmes connus. Les notes de version peuvent être un document technique ennuyeux que personne n’aime lire ou écrire. Mais notre mission en tant que chef de produit, est de rendre à ces notes plus attrayantes, intéressantes et informatives.

Quel est le problème avec eux ?

Trois principaux problèmes associés aux notes de version sont
– la gestion,
– la communication brisée,
– et un canal de distribution.

Le plus grand problème auquel nous sommes confrontés est le manque de communication au sein de l’équipe. Même dans les petites entreprises, l’équipe technique a du mal à expliquer ce qui a été modifié. Souvent, ils corrigent quelque chose, et quelques semaines plus tard, ils oublient aussi ce qui a été fait ce mois-ci.
Bien, et laisser la tâche des notes de version à l’équipe de développement est aussi une erreur. Ils ont tendance à écrire des notes de version très techniques pour des personnes ayant un doctorat en informatique.
Les lecteurs ne se soucient pas de savoir comment quelque chose a été corrigé ; ils ne se soucient que du résultat final. Comment peuvent-ils bénéficier de la mise à jour ?

Conseils pour rédiger des notes de mise à jour (avec des modèles)

En mettant de côté le sujet de l’humour dans les notes de mise à jour pour plus tard, la majorité des informations des notes de mise à jour peuvent être modélisées sous une forme compréhensible. Ainsi, la prochaine fois qu’un développeur vous enverra des notes sur un bug corrigé ou une nouvelle fonctionnalité, vous gagnerez tous les deux du temps.
Au lieu de recevoir un commentaire d’un développeur qui n’a aucun sens. Vous aurez une compréhension plus profonde de ce qui a changé et de la façon de mieux le communiquer aux utilisateurs finaux.
So, nous en arrivons à ma liste personnelle de conseils et d’astuces que j’utilise pour faire d’excellentes notes de version ! Laissez-vous inspirer et rédigez vos propres modèles de notes de mise à jour de produits ! Les modèles de notes de lancement de produits logiciels sont un excellent moyen de gagner du temps.

1. Ils > Nous

Ne commencez pas par « Nous avons fait ceci ». Les utilisateurs ne se soucient pas de ce que VOUS avez fait, ils ne se soucient que de ce qu’ILS reçoivent de ce que vous avez fait.

Vous pouvez maintenant .
Nouvellement publié est disponible pour votre usage. Maintenant, vous pourrez

2. Se concentrer sur l’utilisateur

Utiliser « VOUS » plus souvent. C’est une astuce de copywriting qui transforme instantanément la façon dont l’information textuelle est perçue. Ils seront inconsciemment plus enclins à lire le texte lorsqu’ils verront « vous ».

Une grande nouvelle pour vous ! vous permet de recueillir les commentaires de vos utilisateurs.
Soyez heureux d’annoncer ce qui vous aide à éviter la perte de données.
Gagnez votre temps avec

3. Suivez des modèles simples de notes de version

Créez ces modèles et demandez à vous, développeurs, de rédiger vos notes dans ce format uniquement. De cette façon, vous éviterez les malentendus et vous saurez exactement ce qui a été modifié et comment cela fonctionne, et quels objectifs cela tente d’accomplir. Ces 4 modèles couvrent à eux seuls 90% de toutes les notes de version.

• Avant X est maintenant Y
• Vous pouvez maintenant faire X au lieu de Y
• X ne fait plus X, Y quand Z, Q, W
• X ne fait plus Y. Cela signifie que vous n’avez plus besoin de faire Z

4. Évitez d’être trop formel

Bien sûr, cela dépend de l’image de marque de votre entreprise. Cependant, les écrits formels sont généralement longs et ne vont pas directement à l’essentiel. Il est donc plus difficile pour les lecteurs de scanner le texte. Essayez d’utiliser un langage cohérent et évitez d’être trop formel sur vos modèles de documents de notes de version.

5. Développez puis simplifiez

Une bonne release note est courte et concise. Cependant, pour y arriver développer le texte, assurez-vous qu’il reflète tout ce qu’une nouvelle fonctionnalité, une correction de bogue est tout au sujet. De plus, une grande partie de la rédaction des notes de version consiste à prendre une grande quantité d’informations et à la comprimer dans de courts paragraphes. Assurez-vous que chaque release note n’est pas sortie de son contexte.

Regardons les meilleurs exemples de Release notes. 3 entreprises avec d’excellentes pages de Release Notes et comment pouvez-vous apprendre d’elles ?

👉Article connexe : Tout ce que vous devez savoir sur les métriques clés en SaaS

Exemples de notes de mise à jour

Exemples de notes de mise à jour de Salesforce

Salesforce est une plateforme CRM avec de nombreux produits sous leur égide. Donc, garder les clients à jour sur les nouvelles fonctionnalités et les changements de produits est l’enfer pour les rédacteurs techniques, les gestionnaires de produits et les développeurs.
Je suppose que la société prépare des notes de version trimestrielles et s’appelle « Salesforce Summer ’19 Release Notes », qui est une page de notes de version très complète avec ses catégories et sous-catégories.
Les notes de version de Salesforce sont un mélange de notes de version régulières ainsi que de carte de produit. Il s’agit d’une explication détaillée de la façon dont chaque fonctionnalité va fonctionner, et spécifiquement à quels utilisateurs elles vont être disponibles.

L’avantage évident de telles pages de notes de version complètes est d’enlever du travail des épaules des départements de support. Par exemple, s’ils reçoivent une question d’un client liée à un sujet spécifique. Ils peuvent facilement les rediriger vers la page, où les utilisateurs peuvent trouver la réponse.

Conseils pro clés à retirer :

1. Comment utiliser la section des notes de version

2. Tableaux détaillés, visuellement compréhensibles, avec une feuille de route du produit

3. Section filtre

4. Explication généralisée, explication généralisée puis suivie d’une description détaillée du fonctionnement d’une nouvelle fonctionnalité.

Salesforce suit également des modèles de notes de version.

Etape 1 : Expliquer en quoi consiste la nouvelle fonctionnalité.
Vous n’avez plus besoin de passer en Salesforce Classic pour gérer les affectations de territoires sur la page Compte. Vous pouvez désormais modifier la liste connexe des territoires attribués dans Lightning Experience. Auparavant, la liste liée était en lecture seule dans Lightning Experience.

Vous n’avez plus à pour effectuer . Vous pouvez désormais effectuer . Auparavant, vous ne pouviez faire que .

Étape 2 : Expliquez comment activer ou accéder à la fonctionnalité
Où : Cette modification s’applique à Lightning Experience dans les éditions Performance et Développeur et les éditions Entreprise et Illimité avec le Sales Cloud.

Étape 3 : Expliquer comment utiliser la fonctionnalité
Comment : Si la mise en page de votre compte inclut la liste connexe Territoires assignés, aucune configuration n’est requise. Cliquez sur Assigner des territoires et assigner pour gérer les affectations.

Exemples de notes de version de Sketch

Si votre produit n’est pas si compliqué et n’est pas une plateforme avec un grand parapluie de sous-outils, vérifiez l’entreprise Sketch.
La disposition est intéressante. Sur le côté droit, vous avez une description détaillée de toutes les nouvelles fonctionnalités et des corrections de bugs et sur le côté gauche, il y a les descriptions des principales grandes fonctionnalités. Et CTA.

Mises à niveau de Smart Distribute

Vous pouvez maintenant utiliser Smart Distribute pour contrôler l’espacement dans les grilles. Vous pouvez facilement ajuster l’espacement vertical entre les rangées de couches, ainsi que l’espacement horizontal entre chaque couche d’une rangée. Nous avons également introduit un nouveau bouton « Tidy » dans l’inspecteur. Il aligne rapidement une sélection de plusieurs calques dans une grille soignée, ce qui facilite encore plus la création et la gestion de mises en page complexes.

De nouveau, nous voyons un modèle simple :
Vous pouvez maintenant faire . Vous pouvez facilement faire . Nous avons également introduit un nouveau .

Dans les améliorations:
Nous avons ajouté une nouvelle commande Sélectionner tout dans le tableau d’art au menu Édition afin que vous puissiez rapidement saisir tous les calques de tout tableau d’art que vous avez sélectionné. Nous avons également donné aux différentes commandes Sélectionner tout leur sous-menu.

• Nous avons ajouté , de sorte que vous pouvez maintenant faire .
• Correction d’un crash qui pouvait se produire lorsque vous essayez et glisser-sélectionner avec l’outil Baguette magique.
• Correction d’un bug où le poids de type correct n’apparaissait pas pour les polices avec le même nom.

– Correction d’un bogue dans les listes de pages et de calques où les sélections ne s’affichaient pas correctement lorsqu’elles étaient connectées à un écran externe.

Alors, pour en revenir aux notes de version orientées utilisateur, nous devons comprendre que nous rédigeons nos notes de version pour notre public cible. Salesforce rédige ses releases pour les personnes sans formation technique, pour les services commerciaux et les marketeurs, les entrepreneurs, les fondateurs, etc.

Le sketch est utilisé par les graphistes et les artistes. Ainsi, tant Salesforce que Sketch utilisent un ton générique, très convivial, orienté pour les vraies personnes.

Getpostman Release Notes Examples

Si votre produit est technique et que vos utilisateurs sont des développeurs, alors l’inverse est une règle empirique. Le plus court, le plus technique, le moins visuellement attrayant est le mieux.

Par exemple, Getpostman est un produit technique pour les développeurs.

Les notes de version peuvent être rapidement parcourues pour avoir une idée générique des nouveautés. Et il suit un format très simpliste.

Numéro de mise à jour, date et informations en une phrase sur chaque mise à jour sans détails sur ce que cela signifie pour un utilisateur, comment l’utiliser ou comment y accéder.

Le plus simple est le mieux. Ils comprendront.

Humour dans les notes de mise à jour

Nous avons déjà parlé des exemples de notes de mise à jour in-app qui sont hilarantes et divertissantes à lire. Cependant, le ton de voix n’est pas adapté à la majorité des entreprises technologiques. Et elles ont besoin d’un guide de style pour les notes de mise à jour. De plus, tous les logiciels n’ont pas une version mobile et la majorité des entreprises publient leurs notes de mise à jour sur une page séparée, quelque part dans la section support ou aide. (Les entreprises enterrent stratégiquement leurs notes de version et se plaignent ensuite de la raison pour laquelle personne ne les lit.)

Il existe de nombreuses façons intelligentes d’annoncer les mises à jour de produits. Par exemple, écrire un excellent email pour présenter les mises à jour du produit ou créer un article de blog séparé.

👉 Article connexe : Les meilleures et les pires app Release Notes qui vont vous inspirer

Comme dans toute chose dans la vie, en apportant une structure et une organisation ainsi que des technologies modernes, nous créons une solution plus facile, qui n’est pas si ennuyeuse et inutile.

Espérons que nos modèles de notes de mise à jour de logiciels
et nos exemples vous ont aidé.