Documentation ou guide d'utilisation

La plupart des équipes confondent deux choses totalement différentes : la documentation d'
et le guide de l'utilisateur.

Ils ont des objectifs différents.
Ils s'adressent à des publics différents.
Ils interviennent à différentes étapes du cycle de vie du tableau de bord.

Qu'est-ce qu'une documentation ?

Définition tirée d'Internet :

Un document technique qui explique comment un système a été conçu, afin de pouvoir le comprendre, l'entretenir ou l'améliorer ultérieurement.

Appliqué aux tableaux de bord :

C'est aux développeurs de comprendre la logique, la structure et les sources de données qui sous-tendent le produit.

À qui s'adresse-t-il ?

Vos collègues lorsqu'ils prennent le relais

Toi, dans cinq mois, en train d'essayer de te rappeler ce que tu as fait

Formats courants :

• Intégré au back-end (annotations, commentaires, onglets masqués)
• Un document Google Docs ou une présentation PowerPoint
• Une ressource dans le wiki de votre organisation

Ce que cela comprend :

• Formules et calculs
• Sources des données et tableaux utilisés
• Limites connues
• Mettre à jour les règles et le calendrier relatifs aux différentes tables de données

Qu'est-ce qu'un guide d'utilisation ?

Un outil destiné à aider les utilisateurs finaux à comprendre comment lire et utiliser correctement le tableau de bord.

Un objectif différent. Un public différent.

Formats courants :

• Un espace dédié au sein du tableau de bord
• Infobulles ou aide intégrée au niveau du graphique
• Une présentation Google Slides ou un dossier d'intégration
• Le portail d'analyse ou le wiki interne de votre entreprise

Ce que cela comprend :

• KPI en langage simple
• Comment utiliser le tableau de bord
• À quoi sert le tableau de bord et à quoi ne sert-il pas ?
• Conseils pour lire et interpréter les illustrations
• Fréquence des mises à jour

Comprendre la différence entre la documentation et le guide d'utilisation est un excellent premier pas, mais cela ne suffit pas à lui seul.

Si vous vous arrêtez là, vous ne faites que mettre des étiquettes sur deux conteneurs.

Pour vraiment aider l'entreprise, il faut aller plus loin :

• Définir une vision du produit.
• Suivez un processus de conception.
• Considérez les tableaux de bord comme de véritables produits, et pas seulement comme des rapports

_{(Cliquez avec le bouton droit de la souris et sélectionnez « Enregistrer sous » pour télécharger l'image en haute résolution)}

Et oui, tout cela sans compromettre la rapidité de mise sur le marché.

Car au final, l'objectif n'est pas simplement de livrer un tableau de bord.
Il s'agit de créer le bon produit, pour le bon problème, destiné aux bonnes personnes.

Ça vous plaît ? D'autres articles vous attendent, directement dans votre boîte mail. Inscrivez-vous à la newsletter .