La plupart des changements fusionnés ne devraient pas apparaître dans une note de version
Les notes de version rédigées à partir d'un journal de commits se lisent comme un journal de commits. On parle aux clients d'une restructuration, d'une montée de dépendance et d'une correction de coquille, et ils cessent de lire dès la troisième ligne. Le seul changement dont ils avaient besoin devient alors invisible.
Une note de version répond à une autre question qu'un journal des modifications : que peut-on faire maintenant qu'on ne pouvait pas faire la semaine dernière, et qu'est-ce qui se comporte autrement. La plupart du travail fusionné ne répond à ni l'une ni l'autre.
Le filtre ne peut pas s'exécuter sur les étiquettes seules, parce qu'une étiquette dit quel type de travail c'était, pas si un utilisateur peut percevoir le résultat. Une correction de performance est interne jusqu'à ce qu'elle change ce que quelqu'un attend.
Rédiger la note est la moitié facile. Décider ce qui y appartient est la moitié qui vaut d'être automatisée avec soin, et la moitié qu'une personne devrait confirmer.
Comment l'ActionFlow s'exécute sur le canevas
Un nœud Start Scheduled ouvre la collecte de la semaine, et un nœud GitHub lit les pull requests fusionnées de la période avec leurs descriptions et étiquettes.
Un nœud Filter retire ce que votre équipe a déjà marqué comme interne, ce qui est peu coûteux et capte l'essentiel du bruit.
Un nœud Text Classifier trie ensuite le reste selon la visibilité utilisateur plutôt que selon le type de travail. Un nœud If achemine tout ce qui est ambigu vers la liste de relecture plutôt que dans la note.
Un nœud Generate Object renvoie, par changement inclus, ce qu'un utilisateur peut désormais faire et ce qui se comporte autrement, formulé du côté de l'utilisateur plutôt que du code.
Un nœud Generate Text assemble la note dans votre structure maison, sous des titres que vos clients reconnaissent déjà des versions précédentes.
Un nœud Notion tient le brouillon. Un nœud Google Docs tient la version en cours de correction, pour que le responsable produit travaille là où il travaille d'habitude.
Un nœud Human in the Loop contrôle la publication. Le flux rédige la note. Une personne décide qu'elle est vraie et l'envoie.
Nœuds utilisés par cet ActionFlow
- Start Scheduled (Start) : ouvre la fenêtre de collecte hebdomadaire.
- GitHub (Integration) : pull requests fusionnées avec descriptions et étiquettes. Bitbucket occupe le même emplacement.
- Filter (Data) : retire les items que l'équipe a déjà marqués comme internes.
- Text Classifier (AI Custom) : trie selon la visibilité utilisateur, pas selon le type de travail.
- If (Control) : achemine les changements ambigus vers la relecture plutôt que dans la note.
- Generate Object (AI Core) : ce qu'un utilisateur peut désormais faire, et ce qui se comporte autrement.
- Google Docs (Integration) : le brouillon où le responsable produit le corrige.
- Email (Human in the Loop) : contrôle la publication. Rien ne part sans avoir été lu.
Questions fréquentes
Newsletter
Recevoir les mises à jour produit
Nouveaux nœuds, agents et notes produit. Nous n'envoyons un e-mail que lorsqu'il vaut la peine de l'ouvrir.