Comment rédiger des notes de version logicielle efficaces
Si votre entreprise ressemble à la plupart, les notes de version des logiciels sont souvent une réflexion de dernière minute, ou perçues comme une corvée inutile. Elles sont rédigées à la hâte et ne comportent parfois qu'une ou deux phrases.
Cependant, vous pouvez transformer ce qui semble être une exigence ennuyeuse en un formidable outil pour engager votre communauté de clients, faire sourire votre public à propos de votre marque, et instaurer un climat de confiance avec vos utilisateurs finaux. C'est votre opportunité de communiquer avec votre base de clients et de signaler au marché le niveau de qualité de votre processus de développement logiciel.
En prenant le temps de rédiger des notes de version efficaces, vous pouvez accroître la satisfaction client et l’adoption de vos produits. Cela améliore l’expérience utilisateur globalement. Sans oublier d'établir un précédent qui montre que votre entreprise gère son cycle de vie de livraison logicielle comme une machine parfaitement huilée.
Vous voulez plus de The CPO Club ?
Inscrivez-vous gratuitement pour terminer la lecture de cet article :
Have an account? Log In
Lorsque j'étais copropriétaire et en charge de la gestion produit & du marketing produit chez DigiQuatics, j'ai utilisé le blog de l'entreprise pour nos mises à jour produits, accompagné de petites publications digestes sur les réseaux sociaux à propos des nouveautés, avec des liens vers le blog, puis en envoyant un e-mail à la liste des abonnés du blog pour notifier la mise à jour.
Mettre en place cette mécanique autour de nos notes de version a permis à nos clients de savoir que leur retour était non seulement écouté, mais également pris en compte. Cela construit la confiance auprès de nos utilisateurs finaux, et permet au travail acharné des chefs de produit et des équipes d’ingénierie de rayonner auprès du reste du monde.
Vous pouvez consulter un exemple d'une de nos mises à jour produit de DigiQuatics ici.
- Comment Créer des Notes de Version Logiciel Impactantes ?
- Modèle Recommandé de Notes de Version
- Exemples de Notes de Version Logiciel
- Outils pour Diffuser les Notes de Version Logiciel
Comment Créer des Notes de Version Logiciel Impactantes
Les notes de version sont une opportunité pour maintenir l’enthousiasme de vos clients autour de votre produit. Mettez en avant les nouvelles fonctionnalités et correctifs de bugs de façon claire et compréhensible. Veillez aussi à inclure des mots-clés afin que les utilisateurs trouvent facilement des informations sur la version via Google ou via la recherche de votre blog.
Il est important d’être clair, concis et informatif lorsqu’on rédige des notes de version. Voici quelques conseils pour écrire des notes de version efficaces (gardez à l'esprit que c'est un excellent cas d'utilisation pour l’IA dans la gestion des versions) :
- Soyez clair – sur ce qui est nouveau dans la version. Quelles fonctions ou fonctionnalités publiez-vous ? Quels bénéfices pour vos clients ?
- Gardez le client au centre – les notes de version ne sont pas des ingénieurs pour les ingénieurs, pensez à l’utilisateur lors de la rédaction, réservez le jargon technique pour les membres de l’équipe qui en ont besoin
- Mettez en avant les corrections de bugs – Précisez quelles anomalies ou défauts ont été corrigés. Les clients seront ravis de voir que vous prenez en compte leurs retours et que vous traitez leurs préoccupations.
- Adoptez un ton adapté – dans vos notes de version. Vous souhaitez faire ressentir l’enthousiasme des améliorations sans donner l’impression de survendre. Après tout, une note de version n’est pas un argumentaire commercial.
- Ajoutez du contenu attrayant – Captez l’attention de vos utilisateurs, intégrez des vidéos, captures d’écran, gifs, liens pertinents, et même la feuille de route produit lorsque c’est pertinent.
Modèle Recommandé de Notes de Version
Bien qu’il n’y ait pas de règle stricte, suivre cette structure vous mènera à une note de version complète et bien rédigée. Considérez-la comme votre modèle pour documenter les nouvelles fonctionnalités, améliorations et corrections de bugs.
- Titre
- Votre titre ou en-tête pour chaque nouvelle fonctionnalité, nouvelle capacité ou mise à jour d'application
- Description
- Quelques phrases sur ce qui est nouveau, quelles ont été les améliorations, ou la solution apportée à un bug
- Médias intégrés
- Toutes captures d'écran, vidéos ou autres contenus complémentaires qui ajoutent de la profondeur à la nouvelle fonctionnalité, capacité ou correction de bug
- Liens pertinents
- Tous liens pertinents vers de la documentation ou des informations techniques sur le produit à destination des ingénieurs de l'audience qui pourraient avoir besoin d'approfondir. Un bon exemple est l'information concernant la consommation de l'API de vos applications. Mais, souvenez-vous, les notes de version elles-mêmes doivent rester générales, concises et engageantes
De nombreuses entreprises incluent également des mentions légales à propos de l'entreprise elle-même ou du produit en question dans les notes de version. Il est aussi recommandé d'ajouter une adresse email ou un lien vers une page de contact, afin que les clients puissent vous joindre si besoin au sujet des notes de version du produit.
Exemples de notes de version logicielles
Exemples de bonnes notes de version par les principales entreprises SaaS
Slack
Slack adopte une approche unique pour ses notes de version. Elles sont en accord avec le ton de marque “fun” partagé par leurs équipes marketing. Les notes sont présentées de façon légère, conversationnelle et amusante. C'est à l'opposé de nombreuses entreprises où les notes de version logicielles sont sèches, ennuyeuses et pleines de jargon technique.
Ils résument même diverses notes de version pour les utiliser sur leurs réseaux sociaux et ainsi tenir les utilisateurs informés des nouveautés de Slack. Les notes de version comme celles de Slack apparaissent généralement dans les App Stores.
Intercom
La manière dont Intercom gère ses notes de version est l'une de mes préférées chez une entreprise SaaS. Comme leurs clients sont souvent des propriétaires d'entreprise, de boutiques Shopify, des éditeurs SaaS ou de grandes entreprises, les utilisateurs finaux de ces mises à jour sont généralement des équipes internes ayant un profil semi-technique.
Ainsi, publier les dernières sorties sous forme de blog, avec un résumé concis des enjeux, et de nombreux GIFs, captures d'écran, vidéos ou tutoriels pour chaque nouvelle version est remarquable et constitue un excellent moyen de diffuser les mises à jour et notes de version. Ce format est aussi parfait pour les notifications par email ou dans l’application.
Ahrefs
Ahref adopte une approche similaire à Intercom avec un format de notes de version basé sur un blog pour leurs produits. Ce que je veux souligner ici, c'est la manière dont ils renforcent la sensibilisation de leurs utilisateurs.
Ils ajoutent une bannière en haut de la page web de leur produit SaaS. C’est une manière intelligente d’informer les utilisateurs finaux des nouveautés à venir. Plus besoin de compter sur des emails qui peuvent finir dans le spam ou un fil d’actualité sur les réseaux sociaux que beaucoup n’utilisent pas forcément.
Exemples de ce qu'il faut éviter dans les notes de version logicielles
Uber
Bien que j’apprécie l’invitation faite aux utilisateurs finaux de noter l’application Uber et de donner leur avis, ceci est un exemple de note de version logicielle bâclée.
De quelle manière la localisation a-t-elle été améliorée et quels sont les correctifs de bugs ou les améliorations de performance ? Cette mise à jour de l’application reste vague et n’apporte aucune information concrète sur ce qui va changer.
Voici un autre exemple de notes de version logicielles faites à la va-vite. Une seule phrase générique « La dernière version contient des corrections de bugs et des améliorations de performance. » Cette mise à jour ne donne aucune indication sur les fonctionnalités mises à jour dans cette nouvelle version, ni s’il y a des changements significatifs de fonctionnalités.
Outils pour diffuser les notes de version logicielle
Il existe de nombreux outils que vous pouvez utiliser pour simplifier la gestion des notes de version de produit. Outre la méthode plus traditionnelle du blog ou l’utilisation d’une liste d’e-mails pour fournir les nouveautés, il y a aussi les résumés que vous trouvez pour les mises à jour sur divers App Stores.
- AnnounceKit : « AnnounceKit aide les entreprises à communiquer les mises à jour et nouvelles produits à leurs clients, à augmenter l’adoption de nouvelles fonctionnalités et à renforcer la confiance des clients. »
- ReleaseNotes : « Créez de belles et engageantes notes de version pour tenir vos clients et parties prenantes informés, ou comme outil marketing pour convertir davantage. Publier et promouvoir vos notes de version augmente la notoriété, l’engagement et la confiance. »
- MagicBell : « La boîte de réception de notifications pour votre produit. Ajoutez MagicBell à votre produit pour les annonces, la facturation, les flux de travail et autres notifications. »
Pour faciliter votre processus, consultez notre liste d’outils de gestion des versions logicielles.
Pour conclure
En suivant ces conseils, vous pourrez rédiger des notes de version à la fois efficaces et informatives. Les clients apprécieront vos efforts pour les tenir informés des changements apportés au produit.
Merci de votre lecture ! Avez-vous d’autres conseils pour rédiger des notes de version ? Partagez-les dans les commentaires ci-dessous ! Et n’oubliez pas de vous abonner à la newsletter !
Lecture associée : Cycle de vie de la publication logicielle (SRLC) : comprendre les 6 principales étapes
Liste d’outils associés : Outils de gestion des versions logicielles
Podcast associé : Tarification produit : stratégie basée sur la valeur, packaging logiciel, avec Dan Balcauski
À découvrir : Logiciel de gestion d’idées pour gérer de nouvelles idées de produits
