Commentaires

Surveillez la satisfaction des utilisateurs avec des widgets de feedback intégrés, des évaluations de pages et des réactions pouce haut/bas pour identifier les axes d’amélioration.

Pour collecter et consulter les commentaires, vous devez activer la collecte de commentaires depuis la page Modules complémentaires de votre Dashboard.

L’onglet Feedback affiche le nombre de votes positifs (pouce levé) et négatifs (pouce baissé) que votre documentation a reçus, ainsi que tous les commentaires qualitatifs fournis par les utilisateurs. Utilisez ces informations pour évaluer la qualité de votre documentation et l’améliorer.

Consultez les commentaires sur la page Analytics de votre Dashboard.

​

Types de feedback

Les feedbacks contextuels et sur les extraits de code sont en bêta. Pour les activer sur votre site de documentation, contactez notre équipe commerciale.

L’onglet Feedback affiche des informations en fonction des modules complémentaires de feedback que vous activez.

• Évaluation par pouces : système simple de vote pouce levé/pouce baissé pour mesurer la satisfaction globale vis-à-vis des pages.
• Suggestions de modification : permettez aux utilisateurs de proposer des modifications à votre documentation. Disponible uniquement pour les dépôts GitHub publics.
• Création d’issues : permettez aux utilisateurs de créer des issues GitHub directement depuis votre documentation. Disponible uniquement pour les dépôts GitHub publics.
• Feedback contextuel : retour libre sur le contenu d’une page.
• Feedback sur les extraits de code : retour spécifiquement sur les extraits de code.
• Retours des agents : retours soumis par des agents IA tiers qui accèdent à votre documentation.

​

Collecte d’adresses e-mail

Activez la collecte d’e-mails pour que les utilisateurs puissent fournir leur adresse e-mail de manière facultative lors de l’envoi de feedback.

1. Accédez à la page Add-ons de votre dashboard.
2. Activez l’option Collect reader emails dans les paramètres de feedback.
3. Ajoutez éventuellement une mention de confidentialité expliquant comment votre équipe utilise les e-mails collectés.

Consultez les adresses e-mail envoyées avec le feedback dans le dashboard de feedback aux côtés du contenu du feedback.

Si vous désactivez la télémétrie dans votre fichier docs.json, les fonctionnalités de feedback ne sont pas disponibles sur vos pages de documentation.

​

Gérer les retours

Pour les retours contextuels et ceux portant sur des extraits de code, vous pouvez définir le statut d’un retour et ajouter des notes internes afin de suivre l’avancement du traitement des retours des utilisateurs.

​

Modifier le statut des retours

Sélectionnez le statut à côté d’un retour pour le marquer comme En attente, En cours, Résolu ou Ignoré.

Bonnes pratiques pour définir les statuts des retours :

• En attente : le retour est en attente d’examen.
• En cours : le travail est en cours pour traiter le retour.
• Résolu : le retour a été résolu.
• Ignoré : le retour est non pertinent ou inexact.

​

Filtrer par statut

Utilisez le menu Filters pour contrôler quels retours sont affichés. Décochez un statut pour masquer tous les retours ayant ce statut. Par défaut, tous les types de retours sont affichés.

​

Filtrer par type

Sélectionnez entre Ratings by page, Detailed feedback et Code snippets selon les informations que vous souhaitez analyser.

• Ratings by page : consultez les pages qui reçoivent le plus de retours positifs et négatifs. Utilisez ces données quantitatives pour identifier les pages que les utilisateurs trouvent les plus et les moins utiles.
• Detailed feedback : examinez les retours ouverts que les utilisateurs laissent sur les pages pour identifier des améliorations ciblées sur des pages spécifiques.
• Code snippets : examinez les retours ouverts que les utilisateurs laissent sur les extraits de code pour identifier des améliorations ciblées sur des blocs de code spécifiques.

​

Ajouter des notes internes

Cliquez sur un retour pour y ajouter une note interne. Ces notes sont uniquement visibles par les personnes ayant accès à votre Dashboard.

Utilisez les notes pour ajouter des informations afin de faciliter la collaboration, associer des tickets de support ou d’ingénierie pertinents, ou conserver toute autre information utile.

​

Retours des agents

Les retours des agents sont en bêta et susceptibles de changer.

Lorsque des agents IA tiers accèdent à votre documentation, ils peuvent soumettre des retours structurés sur les pages qu’ils trouvent incorrectes, obsolètes ou difficiles à utiliser.

Ces retours apparaissent dans le dashboard de feedback identifiés par un badge Agent. Gérez les retours des agents de la même manière que les retours humains. Définissez des statuts, ajoutez des notes internes et filtrez les retours.

​

Fonctionnement des retours des agents

Vous devez activer les retours des agents dans votre dashboard pour les collecter.

Une fois activé, Mintlify ajoute un bloc <AgentInstructions> contenant les instructions et l’endpoint pour soumettre des retours lorsqu’un agent récupère une page via l’export Markdown.

Les agents envoient des retours à l’endpoint avec le chemin de la page et le texte du retour. Les retours apparaissent dans le dashboard aux côtés des retours humains.

L’endpoint de retours est toujours disponible à l’adresse https://votre-domaine.com/feedback en tant que requête POST, même si vous n’ajoutez pas les instructions à l’export Markdown. Vous pouvez donc inviter les agents à soumettre des retours manuellement en envoyant une requête à l’endpoint.

​

Activer les retours des agents

1. Accédez à la page Add-ons de votre dashboard.

2. Activez l’option Agent feedback.

   

​

Récupérer les retours des agents via API

Utilisez l’endpoint de feedback analytics pour récupérer les retours des agents de manière programmatique. Filtrez par source=agent pour ne retourner que les retours des agents.

Les réponses de retours des agents incluent :

• comment : le texte du retour soumis par l’agent.
• path : le chemin de la page concernée par le retour.

​

Utiliser les données de feedback

Analysez vos données de feedback pour :

• Identifier les contenus les plus efficaces : les pages qui reçoivent le plus de retours positifs montrent ce qui fonctionne bien dans votre documentation.
• Prioriser les améliorations : les pages qui reçoivent le plus de retours négatifs indiquent quels contenus pourraient nécessiter une attention particulière.
• Passer à l’action : mettez à jour votre documentation en vous appuyant sur les retours directs des utilisateurs.