Erreurs fréquentes du contenu d’assistance pour l’IA :
Erreur 1 : Documentation uniquement en PDF
Les PDF manquent de :
- Titres structurés
- Balisage sémantique
- Support du schéma
- Facilité de crawl
Solution : Versions HTML des documents critiques.
Erreur 2 : Vidéo sans texte
L’IA ne regarde pas les vidéos. Il faut :
- Transcriptions complètes
- Résumés texte
- Alternatives textuelles étape par étape
Erreur 3 : Images sans descriptions
« Voir capture ci-dessous » est inutile pour l’IA.
Inclure : « Le menu Paramètres se trouve dans le coin supérieur droit. Cliquez sur l’icône engrenage pour voir Compte, Sécurité et options d’export. »
Erreur 4 : Jargon interne
Mauvais : « Naviguez vers le module CRM et configurez le point de terminaison webhook. »
Bon : « Allez dans la section Gestion clients (CRM) et configurez l’URL de notification automatique (webhook) qui envoie des données à vos autres systèmes. »
Erreur 5 : Supposer les connaissances de l’utilisateur
Ne supposez pas que l’utilisateur sait où se trouvent les éléments. Soyez explicite sur les emplacements et chemins.