mintlify__docs/fr/guides/improving-docs.mdx

---
title: "Améliorez votre documentation"
description: "Utilisez des données et des indicateurs pour améliorer votre documentation."
keywords: ["metrics", "analytics", "bounce rate", "user satisfaction"]
---

<Tip>
  Cette page explique comment mesurer la performance de votre documentation à l’aide d’indicateurs quantitatifs, de retours qualitatifs et de son alignement avec les objectifs métier.
</Tip>

<div id="quantitative-metrics">
  ## Indicateurs quantitatifs
</div>

Quelques exemples à prendre en compte :

* **Pages vues** : Les vues peuvent être un bon indicateur de réussite, mais elles peuvent aussi être liées à du trafic de bots ou à des visiteurs récurrents. Si vous enregistrez de nombreuses vues sur une page d’erreurs ou d’explications, cela peut signaler un problème plus large avec votre produit.
* **Temps passé sur la page** : Un temps plus long passé sur la page peut indiquer de l’engagement, mais peut aussi signifier que les utilisateurs peinent à trouver l’information dont ils ont besoin.
* **Taux de rebond** : Un taux de rebond élevé peut signifier que les utilisateurs n’ont pas trouvé ce qu’ils cherchaient, ou au contraire qu’ils ont trouvé exactement ce qu’ils voulaient et sont partis satisfaits.

L’essentiel est de comparer ces indicateurs dans le temps ou à une valeur de référence afin de repérer des tendances et de comprendre s’ils s’alignent avec les utilisateurs atteignant leurs objectifs.

<div id="correlate-traffic-and-satisfaction">
  ### Mettre en relation trafic et satisfaction
</div>

Utilisez Analytics pour identifier des tendances :

* **Trafic élevé et faibles notes de feedback** : pages populaires avec une mauvaise expérience utilisateur. Priorisez l’amélioration de ces pages.
* **Trafic faible et notes de feedback élevées** : documentation efficace, mais peut-être difficile à découvrir. Envisagez de mettre ces pages en avant.
* **Trafic élevé et notes de feedback élevées** : les incontournables de votre documentation. Passez ces pages en revue pour trouver des idées afin d’améliorer le reste de votre contenu.

<div id="qualitative-feedback">
  ## Retours qualitatifs
</div>

Ajoutez du contexte à vos métriques quantitatives grâce à des informations qualitatives :

* **Retours des utilisateurs** : Utilisez [feedback](/fr/optimize/feedback) pour recueillir le ressenti des utilisateurs via des notes et des commentaires libres, afin de comprendre ce qui fonctionne et où ils rencontrent des difficultés.
* **Contributions des parties prenantes** : Recueillez régulièrement les retours des équipes comme le support, l’ingénierie et la réussite client pour identifier les problèmes courants rencontrés par les utilisateurs et les pistes d’amélioration.
* **Tests utilisateurs** : Menez des tests d’utilisabilité pour vérifier si les utilisateurs trouvent les réponses dont ils ont besoin et si votre documentation est conforme à leurs attentes. Consultez [Comprendre votre audience](/fr/guides/understand-your-audience) pour en savoir plus sur la recherche utilisateur.

<div id="business-alignment">
  ## Alignement avec les objectifs métiers
</div>

Évaluez la documentation au regard des objectifs métiers plus larges :

* **Efficacité du support** : Suivez si votre documentation réduit le volume de tickets de support ou améliore les scores de satisfaction, signe qu’elle répond aux besoins des utilisateurs.
* **Onboarding et adoption** : Mesurez dans quelle mesure la documentation aide les nouveaux utilisateurs à prendre en main le produit, ce qui favorise une adoption plus rapide.
* **Rétention** : Une documentation bien tenue et facile à suivre améliore l’expérience utilisateur, ce qui aide à réduire le churn et à augmenter les taux de rétention.

<div id="put-analytics-into-action">
  ## Mettez vos Analytics en action
</div>

Utilisez ces approches pour prioriser les améliorations de votre documentation :

* **Corrigez d’abord les problèmes à fort impact** : les pages populaires avec de faibles scores de satisfaction touchent le plus d’utilisateurs.
* **Répondez aux retours des utilisateurs** : les retours contextuels et sur les extraits de code permettent d’identifier des zones spécifiques à améliorer.
* **Concentrez-vous sur les parcours utilisateurs clés** : priorisez les pages liées aux tâches les plus importantes pour votre produit.

<div id="related-pages">
  ## Pages associées
</div>

<CardGroup cols={2}>
  <Card title="Vue d’ensemble des Analytics" icon="chart-line" href="/fr/optimize/analytics">
    Consultez les Analytics et suivez les performances de votre documentation.
  </Card>

  <Card title="Commentaires" icon="message-square" href="/fr/optimize/feedback">
    Collectez et analysez les retours des utilisateurs sur votre documentation.
  </Card>

  <Card title="Comprendre votre audience" icon="users" href="/fr/guides/understand-your-audience">
    Étudiez et définissez l’audience de votre documentation.
  </Card>

  <Card title="SEO" icon="search" href="/fr/optimize/seo">
    Optimisez votre documentation pour les moteurs de recherche.
  </Card>
</CardGroup>