Générez des notes de version destinées aux clients

Zero lit les commits et les PR mergées, regroupe les changements par impact client, et rédige des notes de version claires et précises prêtes à publier.

Zero se connecte à :

Ce que Zero livre

Générez des notes de version destinées aux clients — sample output from Zero — screenshot 1

Quel est le problème

Les notes de version sont toujours la dernière chose à être écrite et la première à être coupée quand la version est en retard. Le problème vient du matériau source : des messages de commit écrits pour des ingénieurs, des titres de PR qui supposent un savoir tribal, et 30 PR mergées dont vos utilisateurs se soucient pour la plupart peu individuellement. Le Release Notes Generator inverse le workflow. Zero lit les commits et les descriptions de PR, filtre les changements visibles par le client, les groupe par thème (nouvelles fonctionnalités, améliorations, corrections), et écrit les notes dans la voix que vos clients lisent vraiment. Vous relisez, et la prochaine version part avec des notes au lieu du silence.

Comment Zero le corrige

Étape 1 : Connectez vos outils

GitHub

Requis

GitHub. Zero lit les PR mergées, les messages de commit, les étiquettes et les tags de release. Un accès en lecture au dépôt est requis.

Connecter

Slack

Requis

Slack. Zero livre les brouillons sur le canal de revue et publie les notes finales une fois approuvées. Un accès en écriture au canal est requis.

Connecter

Étape 2 : Demandez à Zero

@Zero pour la version qu'on livre aujourd'hui, lis toutes les PR mergées depuis le dernier tag de release. Groupe par impact client : nouvelles fonctionnalités, améliorations, corrections de bugs. Saute les refactorings internes et les changements de tests. Rédige des notes destinées aux clients dans notre voix produit.

essayer

Zero lit chaque PR mergée dans la fenêtre de version

Zero extrait les PR mergées depuis le dernier tag de release, y compris les titres, descriptions et étiquettes. Les changements internes uniquement (refactorings, tests, ajustements de CI) sont filtrés selon votre convention d'étiquettes.

Zero groupe les changements par impact client

Zero regroupe les PR restantes en thèmes : nouvelles fonctionnalités, améliorations et corrections. Chaque changement est réécrit à partir de la description de la PR en une ligne destinée au client : assez précise pour être utile, sans jargon interne.

Zero rédige les notes dans votre voix produit

Le brouillon final atterrit dans votre outil de docs ou dans Slack avec des sections qui suivent votre modèle de notes de version. Vous éditez pour la voix et la nuance, puis publiez.

Étape 3 : Allez plus loin

Affiner la voix

Mettez à jour les consignes que Zero utilise pour le ton et la mise en forme.

@Zero désormais, saute les en-têtes Markdown dans les notes de version. Prose simple uniquement.

essayer

Enchaîner avec la publication

Poussez les notes approuvées directement vers vos docs ou votre blog.

@Zero une fois que j'approuve les notes, publie-les dans la section Releases de nos docs et publie le lien dans #announcements.

essayer

Traduire

Générez des notes dans chaque locale que vous prenez en charge.

@Zero traduis les notes de version approuvées en allemand, japonais et espagnol. Préserve la structure des sections.

essayer

Conseils pour de meilleurs résultats

●Étiquetez les PR internes uniquement avec une étiquette cohérente (comme `internal` ou `no-release-notes`). Zero ne peut sauter que ce que vous marquez.

●Tenez un court guide de style pour les notes de version dans vos docs. Voix client, verbes actifs, pas de jargon interne. Zero le récupère et l'applique à chaque version.

●Rédigez les notes avant que la version ne parte, pas après. Relire un brouillon pendant que le travail est frais est plus rapide que reconstruire le contexte une semaine plus tard.