Passer au contenu principal
Pour collecter et consulter des commentaires, vous devez d’abord activer la fonctionnalité de commentaires depuis la page Add-ons de votre tableau de bord.
L’onglet Commentaires affiche le nombre de votes positifs et négatifs que vos docs ont reçus, ainsi que les retours qualitatifs fournis par les utilisateurs. Servez-vous de ces informations pour évaluer la qualité de vos docs et les améliorer. Accédez à l’onglet Commentaires 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 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 pouce uniquement : Vote simple pouce levé/baissé pour mesurer la satisfaction globale des pages.
  • Feedback sur extrait de code uniquement : Feedback spécifiquement sur les extraits de code.
  • Évaluation par pouce et feedback contextuel : Vote sur la page, plus commentaires détaillés et motifs des évaluations.
  • Évaluation par pouce et feedback sur extrait de code : Vote sur la page, plus feedback sur les exemples de code.
  • Évaluation par pouce, feedback contextuel et feedback sur extrait de code : Système de feedback complet avec vote sur la page, commentaires détaillés et feedback sur les extraits de code.

​
Gestion des retours

Pour les retours contextuels et les 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 de revue.
  • 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é ignoré car non exploitable, non pertinent ou inexact.

​
Filtrer par statut

Utilisez le filtre de statut pour contrôler les commentaires affichés. Décochez un statut pour masquer tous les commentaires portant ce statut. Par défaut, tous les commentaires sont affichés.

​
Ajouter des notes internes

Cliquez sur un feedback 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 destinées à la collaboration, associer des tickets de support ou d’ingénierie pertinents, ou consigner toute autre information utile.

​
Exploiter les retours utilisateurs

Analysez vos 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 accumulant le plus d’avis négatifs indiquent les contenus qui nécessitent votre attention.
    • Passer à l’action : mettez à jour la documentation sur la base des retours directs des utilisateurs.