Pour collecter et consulter les retours, vous devez d’abord activer la fonctionnalité depuis la page Add-ons de votre tableau de bord.
L’onglet Retours affiche le nombre de votes positifs et négatifs reçus par vos docs, ainsi que tous les commentaires qualitatifs laissés par les utilisateurs. Servez-vous de ces informations pour évaluer la qualité de vos docs et les améliorer. Accédez à l’onglet Retours en vous rendant sur la page Analytics de votre tableau de bord.

​
Types de feedback

Le feedback contextuel et celui 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 selon les modules complémentaires de feedback que vous activez. Activez vos types de feedback préférés :
Capture d’écran des interrupteurs de feedback dans la page Add-ons.
  • Évaluation par pouces uniquement : Vote simple pouce levé/baissé pour mesurer la satisfaction globale des pages.
  • Feedback sur les extraits de code uniquement : Feedback spécifiquement sur les extraits de code.
  • Évaluation par pouces et feedback contextuel : Vote sur la page plus commentaires détaillés et raisons des évaluations.
  • Évaluation par pouces et feedback sur les extraits de code : Vote sur la page plus retours sur les exemples de code.
  • Évaluation par pouces, feedback contextuel et feedback sur les extraits de code : Système de feedback complet avec vote sur la page, commentaires détaillés et retours sur les extraits de code.

​
Gestion des retours

Pour les retours contextuels et sur des extraits de code, vous pouvez définir le statut d’un retour et ajouter des notes internes afin de suivre l’avancement de la résolution 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 retour a été validé et est en cours de traitement.
  • Résolu : le retour a été résolu.
  • Ignoré : le retour a été écarté car non exploitable, non pertinent ou inexact.

​
Filtrer par statut

Utilisez le filtre de statut pour déterminer quels retours s’affichent. Décochez un statut pour masquer tous les retours ayant ce statut. Par défaut, tous les retours sont affichés.

​
Ajouter des notes internes

Cliquez sur un commentaire pour ajouter une note interne. Ces notes ne sont visibles que par les personnes ayant accès à votre tableau de bord. Utilisez les notes pour ajouter des informations utiles à la collaboration, lier des tickets de support ou d’ingénierie pertinents, ou consigner toute autre information utile.

​
Exploiter les retours

Examinez vos données de retours pour :
  • Identifier le contenu performant : Les pages recevant le plus d’avis positifs montrent ce qui fonctionne bien dans votre documentation.
    • Prioriser les améliorations : Les pages recevant le plus d’avis négatifs indiquent quel contenu nécessite votre attention.
    • Passer à l’action : Mettez à jour la documentation en fonction des retours directs des utilisateurs.