Comment rédiger (de meilleures) notes de libération en 7 étapes

Les plats clés

• comprendre votre public cible et leurs raisons de lire les notes de publication; Cela guidera le ton, le contenu et la présentation des notes.
• Documentez clairement les modifications apportées dans la version actuelle, compte tenu de ce que vos lecteurs doivent savoir et quand ils ont besoin d'accéder aux informations.
• Décidez ce qu'il faut inclure dans les notes de publication, équilibrant la profondeur de la couverture de chaque élément en fonction de son importance ou de sa complexité perçue.
• Utilisez des notes de publication bien écrites comme base pour d'autres communications, telles que les articles de blog ou les e-mails, pour mettre en évidence les nouvelles fonctionnalités du produit à différents segments d'utilisateurs.

Pour certaines entreprises, les notes de publication sont le seul moyen de communiquer aux améliorations des produits aux clients. Pour d'autres, ils sont une ligne de touche, développé entièrement séparément des communications utilisateur.

Mais si vous voulez faire plus avec moins - si vous voulez améliorer les communications de rétention de la clientèle sans avoir à faire plus de travail - vos notes de publication pourraient être une réponse inattendue mais précieuse. Surtout s'ils sont bien faits.

Les notes de publication documentent les nouvelles fonctionnalités, les améliorations des fonctionnalités et les corrections de bogues. Ils sont généralement concis et assez directs, et assument naturellement un niveau de familiarité avec votre produit. Le processus que j'ai énoncé ci-dessous devrait faciliter la production de notes de publication de bonne qualité pour votre produit qui répondent à ce besoin pour votre entreprise et vos clients.

Mais, si vous le souhaitez, ce processus vous fournira également un fourrage solide pour d'autres communications de version - comme les e-mails ou les articles de blog ou les visites de fonctionnalités - qui peuvent aider à rappeler aux clients à quel point vous êtes engagé à améliorer ce que vous leur offrez. Et avouons-le, nous voulons tous savoir que nous sommes aimés même après que nous ayons fait un choix et que nous nous sommes inscrits avec un service.

Voyons comment cela peut fonctionner pour vous.

1. Soyez clair sur votre public cible et le but des notes

Qui lit les notes de publication? Pour certains produits, la majorité des utilisateurs consulteront chaque note de version; Pour d'autres, c'est un sous-ensemble spécifique très sélectionné de la base d'utilisateurs principale.

Une fois que vous savez pour qui vous créez les notes de publication, vous pouvez comprendre pourquoi ils lisent les notes. Et cela entraîne l'étape suivante.

Les notes de publication du produit sur lesquelles je travaille ne sont lues par personne, mais un très petit pourcentage d'utilisateurs dans les comptes clients clés. Et ils ont des raisons très spécifiques de lire les notes de publication - certains ont une documentation interne dont ils ont besoin pour se tenir au courant, par exemple.

Mais pour certains produits, les notes de publication sont lues par une grande partie des utilisateurs qui veulent éviter le spin marketing - qui veulent se rendre au cœur du produit et entendre directement de ses fabricants. Des connaissances comme celle-là n'informeront pas ce que vous incluez et excluez - cela peut avoir un impact sur le ton dans lequel vous écrivez les notes et comment vous les présentez.

2. Créez ce dont ils ont besoin pour savoir

Les notes de publication devraient généralement documenter les modifications apportées à la version actuelle de votre produit. Alors évidemment, vous aurez une idée de ce que vous avez besoin de vos lecteurs pour savoir.

Mais il est également important de réfléchir à ce que vos lecteurs pensent avoir besoin de savoir. Par exemple, nous documentons les corrections de bogues d'une manière qui garantit que celui qui a signalé ou remarqué que le bogue sera en mesure de l'identifier dans la liste et de savoir qu'il a été corrigé. Mais nous n'approchons pas en profondeur sur chaque correction de bogue, car personne n'a besoin (ou, pour être honnête, veut lire toutes ces informations.

À ce stade, c'est aussi une bonne idée de considérer quand vos lecteurs auront besoin d'accéder aux notes de publication. Le jour de la sortie? Une semaine auparavant, alors ils ont le temps de les revoir? Cela vous aidera à planifier la création de notes de libération autour du travail de construction et de déploiement de la version.

3. Identifiez ce que vous avez fait dans cette version

Cela semble assez simple, mais si vous mettez un bon processus en place pour cette étape, cela lissera la production de chaque note de version.

Par exemple, vous pourriez décider d'avoir un document partagé que vos développeurs et propriétaires de produits peuvent mettre à jour progressivement à mesure que les travaux sont terminés, plutôt qu'à la toute fin, ce qui peut vous laisser essayer de compiler les notes dans une ruée.

Vous pourriez également diviser ce document en sections qui reflètent les types de travail qui se fait généralement - parlez, les nouvelles fonctionnalités, les améliorations des fonctionnalités existantes et les corrections de bogues. Cela facilitera le coup d'œil si tout dans la version a été inclus dans le document.

Cela facilitera également la structure des notes de version elles-mêmes que si vous aviez simplement une liste non structurée de nouvelles choses.

4. Décidez de ce que vous devez inclure

car ils contribuent des informations à votre document de note de publication, vos développeurs et propriétaires de produits ne penseront probablement pas à l'utilisateur final. Ainsi, en ce qui concerne la préparation des notes de publication, vous devrez déterminer les bits d'informations à inclure et lesquelles peuvent être omises.

Je pense en particulier aux corrections de bogues que j'ai mentionnées ci-dessus, mais vous devrez peut-être également équilibrer les contributions voluptiques de certains contre les contributions plus minces des autres aux notes.

Plus de mots, de captures d'écran et de détails sur une fonction ou une amélioration qu'une autre sera généralement considérée la liste.

5. Élaborez un scénario ou une messagerie si vous avez besoin de

Ce n'est pas toujours nécessaire, mais parfois un scénario peut aider à mettre vos améliorations en contexte. Je ne parle pas d'ajouter des mots pour le bien ici, ou de transformer vos notes de version concises agréables en un outil de marketing. Ce que je veux dire, c'est que l'ordre dans lequel vous présentez vos informations peut aider les utilisateurs à comprendre les modifications que vous avez apportées. Alors pensez à travers.

Par exemple, une note de version récente que j'ai préparée a fait mention d'un lifting pour le produit, ainsi qu'un ajout de fonctionnalités majeurs. Le lifting impliquait de simples changements cosmétiques - il n'a pas affecté la fonctionnalité des emplacements des éléments dans l'interface. L'ajout de fonctionnalités était un travail beaucoup plus important, avec des implications à long terme plus importantes pour les utilisateurs.

Lequel couvririez-vous en premier? Nous avons choisi d'ouvrir avec le lifting, car c'est ce que les utilisateurs remarqueraient d'abord la prochaine fois qu'ils utilisaient notre logiciel. La nouvelle fonctionnalité a été répertoriée après cela, mais contenait plus de captures d'écran et de détails. L'une des raisons pour lesquelles cela était bien logique, c'est parce que la nouvelle fonctionnalité semblait significativement différente de celle du reste de l'application, donc la mettre dans le contexte d'un rafraîchissement visuel nous a permis de sauter plus de discussion sur ce fait.

6. Rédigez vos notes

La plupart des utilisateurs s'attendent à ce que la version notée soit directe et concise. Ils sont là pour obtenir les faits. Cela dit, il est probablement préférable d'interpréter chaque fonctionnalité ou de réparer du point de vue de votre public cible. Qu'est-ce que cela signifie pour eux?

Par exemple, une modification de votre application peut faciliter la configuration des comptes d'utilisateurs supplémentaires pour les clients d'entreprise. Ce que cela signifie pour les utilisateurs des notes de version est: il est plus rapide ou plus facile pour le nouveau personnel avec ces clients d'avoir accès au compte d'entreprise. Alors, mettez-le en ces termes.

7. Réutilisez ce dont vous avez besoin pour d'autres communications

s'ils sont bien planifiés et écrits, vos notes de publication peuvent agir comme un tremplin pour d'autres communications, peut-être destinées à d'autres segments d'audience utilisateur, pour souligner ce qui est nouveau dans votre produit.

Une fois que vous avez cloué les notes de publication, il devrait être assez facile de voir ce qui peut être reformulé en notifications ou visites dans l'application, utilisé pour revoir le contenu d'aide, et réutilisé et développé en articles de blog, articles de newsletter et Autre contenu de rétention.

Comment développez-vous des notes de publication?

c'est tout - pas une procédure difficile, bien que si vous avez un certain nombre de pièces mobiles dans votre processus de production, les notes de libération peuvent prendre un certain fait.

Mais si vous produisez de bonnes notes de libération, vous pouvez tirer beaucoup plus du travail que vous y mettez. Ils peuvent vous donner une véritable longueur d'avance lorsqu'il s'agit de communiquer sur des modifications à un public plus large que de lire vos notes de sortie maintenant.

avez-vous un processus pour produire des notes de sortie? Et jouent-ils dans vos efforts de conservation de la clientèle? J'adorerais savoir comment vous le faites dans les commentaires.

Les questions fréquemment posées sur la rédaction de meilleures notes de publication

Quels sont les éléments clés à inclure dans les notes de publication efficaces?

Les notes de version efficaces devraient inclure un titre clair, une introduction, une liste de nouvelles fonctionnalités, des améliorations et des corrections de bogues et tout problème connu. Il est également avantageux d'inclure une section de remerciements et une conclusion. Le titre doit être concis et descriptif, tandis que l'introduction devrait fournir un bref aperçu de la version. La liste des nouvelles fonctionnalités, améliorations et correctifs de bogues doit être détaillée et facile à comprendre. La section des problèmes connus devrait informer les utilisateurs de tout problème potentiel et comment les éviter. Enfin, les remerciements et la conclusion peuvent être utilisés pour remercier l'équipe et les utilisateurs, et pour fournir des informations sur les futures mises à jour.

Comment puis-je rendre mes notes de publication plus engageantes?

pour faire de votre version Notes plus attrayantes, utilisez un ton conversationnel et évitez le jargon technique. Utilisez des puces et des sous-titres pour briser le texte et faciliter la lecture. Incluez des visuels tels que des captures d'écran ou des GIF pour illustrer de nouvelles fonctionnalités ou améliorations. Vous pouvez également inclure des témoignages d'utilisateurs ou des citations de l'équipe de développement pour ajouter une touche personnelle.

À quelle fréquence dois-je publier des notes de publication?

La fréquence des notes de publication dépend du cycle de développement de votre produit . Si vous avez des mises à jour régulières, il est préférable de publier des notes de version avec chaque nouvelle version. Cependant, si les mises à jour sont moins fréquentes, vous pouvez publier des notes de version trimestriellement ou semestrielles. La clé est de tenir vos utilisateurs informés des modifications et des améliorations de votre produit.

Dois-je inclure les détails techniques dans mes notes de publication?

Bien qu'il soit important de fournir des informations détaillées sur les modifications de Votre produit, évitez d'inclure trop de détails techniques dans vos notes de publication. Au lieu de cela, concentrez-vous sur l'explication des avantages des nouvelles fonctionnalités ou améliorations pour les utilisateurs. Si nécessaire, vous pouvez fournir un lien vers une documentation technique plus détaillée.

Comment puis-je obtenir des commentaires sur mes notes de publication?

Vous pouvez obtenir des commentaires sur vos notes de publication en demandant à vos utilisateurs directement . Incluez un formulaire de rétroaction ou une section de commentaires dans vos notes de publication. Vous pouvez également utiliser les réseaux sociaux ou les forums des utilisateurs pour recueillir des commentaires. Cela vous aidera non seulement à améliorer vos notes de publication, mais aussi à créer une relation plus forte avec vos utilisateurs.

Comment puis-je utiliser des notes de version pour promouvoir mon produit?

Les notes de publication peuvent être un puissant outil de marketing. Mettez en surbrillance les nouvelles fonctionnalités et améliorations de votre produit et expliquez comment ils peuvent bénéficier aux utilisateurs. Vous pouvez également inclure un appel à l'action, encourager les utilisateurs à essayer la nouvelle version ou à fournir des commentaires. Partagez vos notes de publication sur votre site Web, les médias sociaux et les newsletters par e-mail pour atteindre un public plus large.

Que dois-je éviter dans mes notes de publication?

Éviter d'utiliser le jargon technique, des descriptions vagues et Langue négative dans vos notes de publication. Évitez également de faire des promesses sur les mises à jour futures, sauf si vous êtes sûr de pouvoir livrer. Gardez vos notes de publication concises, claires et concentrées sur les besoins de l'utilisateur.

Comment puis-je rendre mes notes de publication plus accessibles?

pour rendre vos notes de publication plus accessibles, utilisez un langage clair et simple . Rompez le texte avec des puces et des sous-titres et utilisez des visuels pour illustrer des concepts complexes. Assurez-vous également que vos notes de publication sont faciles à trouver sur votre site Web ou votre application.

Dois-je traduire mes notes de publication dans d'autres langues?

Si votre produit a une base d'utilisateurs globale, c'est un Bonne idée de traduire vos notes de publication dans d'autres langues. Cela vous aidera à atteindre un public plus large et à montrer que vous appréciez vos utilisateurs internationaux.

Comment puis-je améliorer mes notes de publication au fil du temps?

Recueillir en continu les commentaires de vos utilisateurs et surveiller les performances de vos notes de sortie. Utilisez ces informations pour apporter des améliorations et des ajustements. Continuez également aux meilleures pratiques et aux tendances de la rédaction de notes de publication. N'oubliez pas que les notes de libération efficaces sont le résultat de l'apprentissage et de l'amélioration continus.

Ce qui précède est le contenu détaillé de. pour plus d'informations, suivez d'autres articles connexes sur le site Web de PHP en chinois!