Mettez à jour automatiquement la documentation à partir des questions de support

Quand la même question de support apparaît trois fois, Zero rédige une mise à jour de la documentation et dépose une PR pour que la personne suivante trouve la réponse avant de poser la question.

Zero se connecte à :

Ce que Zero livre

Mettez à jour automatiquement la documentation à partir des questions de support — sample output from Zero — screenshot 1

Quel est le problème

Chaque canal de support compte cinq ou six questions qui ne meurent jamais, non pas parce que le produit est déroutant, mais parce que la documentation n'en parle pas. Suivre ces fils manuellement, rédiger des mises à jour et pousser des PR est le genre de travail qui passe toujours à la trappe. Le Docs Auto-Update surveille vos canaux de support, compte les questions récurrentes, et dès qu'une question a été posée trois fois ou plus par des personnes différentes, il rédige une mise à jour de la documentation et dépose une PR. Un relecteur passe deux minutes à approuver. La personne suivante qui a la même question trouve la réponse au lieu de poser la question.

Comment Zero le corrige

Étape 1 : Connectez vos outils

Slack

Requis

Slack. Zero lit vos canaux de support pour détecter les questions récurrentes. Un accès en lecture aux canaux que vous nommez est requis.

Connecter

GitHub

Requis

GitHub. Zero rédige les mises à jour de docs sous forme de PR sur le dépôt de votre site web. Un accès en écriture au dépôt est requis pour que Zero puisse créer des branches et ouvrir des PR.

Connecter

Notion

Optionnel

Notion. Optionnel. Utile si votre documentation interne vit dans Notion et que vous voulez que Zero la mette à jour aussi.

Connecter

Étape 2 : Demandez à Zero

@Zero chaque semaine, scanne #support et #community pour les questions qui ont été posées par 3 personnes différentes ou plus au cours des 14 derniers jours. Pour chacune, rédige une mise à jour de la documentation et ouvre une PR sur le dépôt du site web avec le changement.

essayer

Zero surveille vos canaux de support à la recherche de questions récurrentes

Zero lit les fils de support entrants, regroupe sémantiquement les questions similaires, et compte les auteurs uniques. Les questions de 3 utilisateurs distincts ou plus sur une fenêtre glissante sont signalées comme des lacunes de documentation.

Zero rédige une mise à jour de la documentation à partir des réponses résolues

Pour chaque question signalée, Zero lit la résolution du fil, identifie le bon emplacement dans la documentation (section existante ou nouveau guide), et rédige la mise à jour au format markdown de votre site avec des exemples concrets.

Zero dépose une PR pour revue

Chaque brouillon atterrit comme une PR dans le dépôt de votre site web, avec les fils de questions déclencheurs liés dans la description. Un relecteur de l'équipe docs approuve ; vous n'écrivez pas à partir de zéro.

Étape 3 : Allez plus loin

Acheminer vers le bon relecteur

Assignez les PR au responsable du composant plutôt qu'à un relecteur générique.

@Zero lors de la rédaction de docs pour une question de facturation, mentionne @billing-team sur la PR au lieu de @docs-team.

essayer

Publier automatiquement les mises à jour à faible risque

Laissez les corrections de fautes et les petites clarifications partir sans revue humaine.

@Zero pour les PR de docs de moins de 50 lignes qui ne touchent que des sections existantes, active l'auto-merge une fois que la CI passe.

essayer

Élargir la couverture

Ajoutez de nouveaux canaux sources pour le signal.

@Zero scanne aussi la boîte de réception Gmail du support pour les questions récurrentes, pas seulement Slack.

essayer

Conseils pour de meilleurs résultats

●Réglez le seuil de 'récurrence' à 3 auteurs uniques sur 14 jours, pas 1. À 1 vous ne faites que réécrire la documentation chaque jour ; à 3 vous attrapez de vraies lacunes.

●Incluez toujours les fils sources dans la description de la PR. Les relecteurs peuvent voir les questions originales et juger si le brouillon y répond vraiment.

●Associez-le à KB Capture pour que les fils résolus alimentent votre base de connaissances interne en parallèle.