# Des notes de version rédigées à partir de vos pull requests Chaque pull request fusionnée se classe seule dans un fil. Le jour de la sortie, @GPT en tire un brouillon de notes, et la version que vous publiez arrive là où vos clients la lisent. ## En bref - **Pour:** Les mainteneurs et les petites équipes qui livrent depuis GitHub. - **Vous tenez:** Deux fils : un flux des pull requests du dépôt, et Versions, partagé par lien avec vos clients. - **Se classe tout seul:** - Chaque pull request dans le flux, quand elle est ouverte, fusionnée ou fermée. - Chaque version que vous publiez sur GitHub, avec ses notes, dans Versions. - Un brouillon des notes par @GPT, avec votre propre clé d’API, quand vous le demandez. - **Le moment:** Le jour de la sortie, @GPT lit les pull requests fusionnées dans le flux et rédige les notes. Vous corrigez une ligne et publiez, et la version arrive dans Versions, où vos clients la lisent. - **Offre:** Pro · Les clients lisent Versions via un lien, sans compte. ## Avant Jour de sortie. Le changelog doit être prêt, et 23 pull requests ont été fusionnées depuis la 2.3. Vous les rouvrez une à une pour comprendre ce qu’un client remarquerait, puis vous rédigez tout à la hâte. Les clients qui avaient demandé l’export CSV apprennent sa sortie par une réponse à un ticket de support. ## Pourquoi un fil, et pas un fichier CHANGELOG ### Les pull requests sont déjà là Chacune arrive dans le flux avec son titre, son lien et sa date au moment où elle est fusionnée. ### Un premier jet à partir du flux @GPT lit les titres des pull requests fusionnées depuis la dernière version, les regroupe pour un client et laisse de côté les mises à jour de dépendances. ### Les clients lisent via votre lien Versions est partagé avec Toute personne avec le lien. Chaque version que vous publiez sur GitHub y apparaît avec ses notes. ## Un fil, au fil du temps Votre espace de travail démarre vide. ### Pull requests d’invoice-app Travail · Actif #### mer. 21 oct. *Le flux se remplit tout seul à mesure que les pull requests sont fusionnées.* via **GitHub** · 14:02 Pull request merged: Add CSV export for invoices github.com/acme/invoice-app/pull/318 #### jeu. 22 oct. via **GitHub** · 09:40 Pull request merged: Fix rounding in multi-currency totals github.com/acme/invoice-app/pull/321 #### ven. 23 oct. via **GitHub** · 16:15 Pull request merged: Bump dependencies github.com/acme/invoice-app/pull/324 #### mar. 27 oct. *Jour de sortie : une demande dans le flux, avec votre propre clé OpenAI.* **Vous** · 10:05 À **@GPT** Répondu en 1 min @GPT rédige les notes de version de la 2.4 à partir des pull requests fusionnées depuis la 2.3, sortie le 6 octobre. Regroupe-les en Nouveau, Corrigé et Modifié, pour les clients, et laisse de côté les mises à jour de dépendances. *Son brouillon est une note, sous les pull requests qu’il a lues.* **De @GPT** · 10:06 Notes de version 2.4, brouillon : Nouveau : exportez vos factures en fichier CSV. Corrigé : les totaux des factures multidevises ne sont plus faux d’un centime. Modifié : les relances de paiement partent à 9 h dans le fuseau horaire de votre client. *Vous corrigez ce qu’il ne pouvait pas savoir, publiez, et la version se classe seule dans Versions.* **Vous** · 10:20 Corrigé la ligne sur le CSV : l’export est dans le menu Factures. Publié la 2.4 sur GitHub avec ces notes. ↳ Versions · 27 oct. ## Ça se classe tout seul. Vous lisez. Vos outils écrivent dans les fils que vous choisissez, avec seulement l’accès que vous leur donnez. [Script ou API](https://thread.page/help/connections/custom.md) ### Les pull requests de GitHub Chaque pull request du dépôt ouverte, prête pour la revue, fusionnée ou fermée devient une note dans le flux. #### Configurer Automatisation Ajouter des notes depuis une autre app Pull requests GitHub 1. Dans **Paramètres → Connexions → Automatisations**, choisissez **Connecter une automatisation** → **Ajouter des notes depuis une autre app** et nommez-la GitHub : ses notes l’indiqueront. 2. Dans **Ajoute à**, choisissez **Pull requests d’invoice-app** ; dans **Ce qui est envoyé**, **Pull requests GitHub**. 3. Dans **Settings → Webhooks** du dépôt, collez l’URL et le secret, choisissez `application/json` et Pull requests. ### Les versions publiées, pour les clients Chaque version que vous publiez devient une note dans Versions, avec son nom, son lien et ses notes. Les clients lisent le fil via son lien. Dans Versions via **GitHub** · 10:21 Invoice app 2.4 github.com/acme/invoice-app/releases/tag/v2.4.0 Nouveau : exportez vos factures en fichier CSV, depuis le menu Factures. #### Configurer Automatisation Ajouter des notes depuis une autre app Versions GitHub 1. Dans **Paramètres → Connexions → Automatisations**, choisissez **Connecter une automatisation** → **Ajouter des notes depuis une autre app**. Nommez-la Versions GitHub, puis choisissez **Versions** et **Versions GitHub**. 2. Dans **Settings → Webhooks** du dépôt, collez l’URL et le secret, choisissez `application/json` et Releases. 3. Dans le menu du fil Versions, choisissez **Partager…**, réglez **Accès général** sur **Toute personne avec le lien** et envoyez le lien à vos clients (voir l’ [Aide sur le partage](https://thread.page/fr/help/sharing.md)). ### Les notes, en brouillon Écrivez à @GPT dans le flux. Il lit les pull requests fusionnées et répond par un brouillon, avec votre propre clé d’API. #### Configurer Modèle d’IA Votre clé d’API OpenAI ou Anthropic Pro avec la synchronisation 1. Dans **Paramètres → Connexions**, ouvrez **Modèles d’IA**, choisissez **Claude** ou **GPT**, collez une clé d’API Anthropic ou OpenAI et choisissez **Connecter**. Les modèles d’IA nécessitent Pro avec la synchronisation activée. 2. Dans le flux, écrivez `@GPT`, la version et ce qu’il faut laisser de côté, puis choisissez **Envoyer**. ## Limites - Ajouter les webhooks nécessite un accès administrateur au dépôt. - Un lien partagé est destiné aux personnes à qui vous l’envoyez : les moteurs de recherche ne le référencent pas, il ne remplace donc pas une page de changelog publique. - @GPT lit le titre et le lien de chaque pull request, pas sa description ni son code : des titres clairs donnent un brouillon clair. - @GPT a besoin d’une clé d’API OpenAI, et le fournisseur facture chaque réponse sur cette clé. Dans un fil que vous partagez, il ne répond qu’après que vous avez choisi Autoriser ici. - ThreadPage envoie ce que lit le modèle à OpenAI avec votre clé. GitHub, GPT, Claude, OpenAI et Anthropic sont les noms de leurs propriétaires. ThreadPage est indépendant, sans affiliation ni approbation de leur part. ## Commencez par un fil. [Essayer gratuitement](https://thread.page/auth/sign-up?returnTo=%2Fapp%2Fsettings%2Fbilling%23trial) 14 jours de Pro. Sans carte. Se termine automatiquement. Choisissez de continuer avec Pro pour 99,99 $US par an (8,33 $US par mois). [Voir les tarifs mensuels](https://thread.page/fr/pricing.md) [Écrire](https://thread.page/app) [Voir les offres](https://thread.page/fr/pricing.md) Autres cas d’usage ### [Le journal de réussites que votre dépôt aide à écrire](https://thread.page/fr/use-cases/brag-doc.md) Les pull requests de votre dépôt se classent toutes seules dans un fil à part. Vous notez ce que git ne voit pas, et au moment de l’évaluation, votre agent rédige à partir des deux. Pro · des pull requests et des agents ### [Un incident, noté pendant qu’il se déroule](https://thread.page/fr/use-cases/incident.md) Deux lignes dès que quelque chose change, et chaque note garde sa minute. Vendredi, @Claude lit le fil et rédige la chronologie du post-mortem. Pro · partage et @Claude [Tous les cas d’usage](https://thread.page/fr/use-cases.md)