Passer au contenu principal
Cette page explique comment identifier votre public, mener des recherches utilisateur et écrire en tenant compte de leurs besoins.

​
Identifiez votre public principal

Écrire pour plusieurs publics conduit à des compromis qui ne satisfont personne. Chaque contenu doit être axé sur une seule persona utilisateur. Votre public peut être :
  • Des décideurs techniques qui évaluent votre produit et souhaitent comprendre des éléments de haut niveau comme des aperçus d’architecture.
  • De nouveaux utilisateurs qui veulent commencer à utiliser votre produit pour la première fois.
  • Des développeurs chargés d’intégrer votre produit et qui ont besoin d’instructions pour une tâche spécifique.
Avant de rédiger une page, demandez-vous ce que votre lecteur cherche à accomplir et quelles connaissances il a déjà.

​
La recherche utilisateur est essentielle

Votre équipe doit s’accorder sur votre audience principale, mais ne vous fiez pas uniquement à l’intuition. Les meilleures informations proviennent d’échanges directs avec les utilisateurs. Il peut exister un décalage entre la façon dont nous concevons nos produits et la manière dont les gens les utilisent réellement. Parlez aux utilisateurs pour comprendre :
  • Comment décrivent-ils ce que fait votre produit ?
  • Utilisent-ils des mots ou des appellations inattendus pour parler de votre produit ?
  • Sur quels sujets aimeraient-ils en savoir davantage ?
  • Qu’est-ce qui manque explicitement à votre documentation ?
Échanger directement avec les utilisateurs permet d’ancrer votre rédaction dans leur perspective, afin de produire une documentation qui leur est utile et les rapproche de leurs objectifs.

​
Conseils et astuces pour comprendre votre public

  1. Travaillez au plus près du support. Vous constaterez les problèmes qu’une documentation incomplète peut engendrer. Demandez à votre équipe support comment les utilisateurs perçoivent le produit et quels sont les problèmes les plus fréquents qu’ils rencontrent.
  2. Intégrez des mécanismes de feedback. Qu’il s’agisse de pouces levés/baissés ou de champs de texte, offrez aux utilisateurs la possibilité de donner leur avis au fil de la lecture de votre documentation.
  3. Utilisez les Analytics pour vous guider. Passez en revue les retours et les insights pour comprendre où les utilisateurs rencontrent des difficultés et où ils réussissent. Mettez à jour la documentation sur laquelle les utilisateurs butent ou qui est la plus étroitement liée aux tâches clés de votre produit.
Il y aura toujours des cas limites qui ne sont pas couverts par votre documentation. Priorisez les pages les plus importantes pour aider le plus grand nombre. Trop de contenu devient difficile à parcourir et à maintenir, et tenter de documenter chaque scénario possible peut être contre-productif.